Re: [Python-ideas] Off topic: 'strike a balance' - second language English

Hi Greg You (and a reddit user) wrote: >> Matlab says: "Here, copy paste this and it'll work". >> To the point that the workspace is designed to automatically strip >>> >> from any copy and pasted commands. > Maybe this is something Python's REPL should do? Good idea. Maybe this is something

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

Jonathan Fine wrote: Matlab says: "Here, copy paste this and it'll work". To the point that the workspace is designed to automatically strip >>> from any copy and pasted commands. Maybe this is something Python's REPL should do? -- Greg ___

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

I wrote: > No mention here, or elsewhere on the page, that [>>>] at the top > right of a code example toggles the presence or absence of prompts. Now raised, and cross-referenced as an issue. https://bugs.python.org/issue34451 docs: tutorial/introduction doesn't mention toggle of prompts

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

Hi Steve You wrote: > I would just like to point out that the ipython %paste magic very > handily strips leading >, ... & + characters from the pasted block, > (there is also some clever dedenting done). [useful example, snipped] > Which is ideal. I personally find that many beginners get on a

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

Chris Angelico wrote > Where in the linked-to What's New page is there an example of that? > There are several code blocks that ARE copy/pasteable, even into the > vanilla interpreter. Good question. The reddit user wrote.

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

On Wed, Aug 22, 2018 at 2:55 AM, Jonathan Fine wrote: > Nick Loadholtes wrote (elsewhere, quoted in this thread - by me). > >> Make your docs work as hard as your code does. Clear examples will >> make your code stand out in a good way. > > With a bit more searching I found: > >

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

On 21/08/2018 17:55, Jonathan Fine wrote: > Nick Loadholtes wrote (elsewhere, quoted in this thread - by me). > >> Make your docs work as hard as your code does. Clear examples will >> make your code stand out in a good way. > > With a bit more searching I found: > >

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

Nick Loadholtes wrote (elsewhere, quoted in this thread - by me). > Make your docs work as hard as your code does. Clear examples will > make your code stand out in a good way. With a bit more searching I found:

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

Hi Earlier today, I did a search for 'documentation by example python' and found Example of great documentation in Python: Nick Loadholtes (copied) https://ironboundsoftware.com/blog/2017/12/11/great-documentation-python/ The example is:

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

On 8/20/2018 5:13 PM, Barry Scott wrote: On 20 Aug 2018, at 17:07, Chris Barker via Python-ideas > wrote: > Summary: I look at the phrase 'strike a balance' in different languages, It is interesting that you picked up on "strike a balance" which

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

On Mon, Aug 20, 2018 at 09:07:20AM -0700, Chris Barker via Python-ideas wrote: > (side note -- are all domain-specific technical term "jargon"? Yes. But not all jargon is a domain-specific technical term. https://en.wiktionary.org/wiki/jargon -- Steve

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

> On 20 Aug 2018, at 17:07, Chris Barker via Python-ideas > wrote: > > > Summary: I look at the phrase 'strike a balance' in different languages, > > It is interesting that you picked up on "strike a balance" which has > been a standard English phrase for a very long time rather than the

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

> On 20 Aug 2018, at 07:35, Jacco van Dorp wrote: > > I would consider conciseness and accuracy most important. Using jargon but > linking to accurate explanations would, in my not exactly humble opinion, be > the best way to go about it. +1 my thoughts exactly. >

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

> > > Summary: I look at the phrase 'strike a balance' in different languages, > > It is interesting that you picked up on "strike a balance" which has > been a standard English phrase for a very long time rather than the much > more resent, (and itself a form of jargon), "dumbing down". > > The

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

I would consider conciseness and accuracy most important. Using jargon but linking to accurate explanations would, in my not exactly humble opinion, be the best way to go about it. ___ Python-ideas mailing list Python-ideas@python.org

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

On Sat, Aug 18, 2018 at 2:48 AM Steve Barnes wrote: > "The removal of technical terminology needs to be moderated to account > for the risk of loss of the essential meaning or the meaning being lost > due to excessive length. Where such terminology is widely accepted > within a given

Re: [Python-ideas] Off topic: 'strike a balance' - second language English

On 18/08/2018 10:34, Jonathan Fine wrote: > Summary: I look at the phrase 'strike a balance' in different languages, > and rewrite some wikipedia text on accessibility. > > I found in https://en.wikipedia.org/wiki/Jargon#Accessibility_issues > === > There is a balance to be struck, as

[Python-ideas] Off topic: 'strike a balance' - second language English

Summary: I look at the phrase 'strike a balance' in different languages, and rewrite some wikipedia text on accessibility. I found in https://en.wikipedia.org/wiki/Jargon#Accessibility_issues === There is a balance to be struck, as excessive removal of technical terminology from a document leads