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
https://mail.python.
Hi Stephen
I've just been reading the (excellent) discussion, started by Victor Stinner
[Python-Dev] Translated Python documentation
https://mail.python.org/pipermail/python-dev/2017-February/147416.html
# Start of thread.
You wrote, and asked for comments on:
> Finally, before getting the pro
Hi Stephen
Thank you for your message. I'll respond just to a few of your comments.
HOW MUCH EFFORT ON DOCS
==
Myself and you wrote:
>> Summary: Discussion of the words 'jargon' and 'chatter'. Recommend
>> that we learn better how to find a compromise (strike a balance)
вс, 19 авг. 2018 г. в 17:51, Chris Angelico :
> On Mon, Aug 20, 2018 at 12:43 AM, Kirill Balunov
> wrote:
> >
> [...]
> > I have the same feeling and already have asked the same question before
> > https://mail.python.org/pipermail/python-list/2018-February/731241.html.
> The
> > main take away w
On Mon, Aug 20, 2018 at 12:43 AM, Kirill Balunov
wrote:
>
> чт, 16 авг. 2018 г. в 22:37, Chris Barker via Python-ideas
> :
>>
>>
>> I wonder why locals doesn't return a Mapping Proxy, or other read-only
>> mapping object?
>>
>> If it's not guaranteed to be THE locals dict, and changes *may* not af
чт, 16 авг. 2018 г. в 22:37, Chris Barker via Python-ideas <
python-ideas@python.org>:
>
> I wonder why locals doesn't return a Mapping Proxy, or other read-only
> mapping object?
>
> If it's not guaranteed to be THE locals dict, and changes *may* not affect
> the real one (but may), a read-only o
tl;dr I don't think so, not very much. There are bigger fish to fry.
I would appreciate comments on the last paragraph (before the
footnotes), which can be read standalone. If opinion is at all
favorable, I'll raise it with the PSF.
Jonathan Fine writes:
> Summary: Discussion of the words 'ja
