Chistopher Barker wrote:
> I'd suggest you make a PR on the docs.

Yeah I was planning on either doing that, or opening it as a "newcomer
friendly"/"easy" issue on bugs.python.org. IMO, it could make for a decent
first PR.

On Sun, Mar 22, 2020 at 1:28 PM Christopher Barker <python...@gmail.com>
wrote:

> On Fri, Mar 20, 2020 at 8:52 PM Kyle Stanley <aeros...@gmail.com> wrote:
>
>> >
>> https://docs.python.org/3/reference/lexical_analysis.html#reserved-classes-of-identifiers
>>
>> I remembered the existence of this rule and tried to locate it recently
>> (prior to this discussion), but was unable to because it doesn't explicitly
>> mention "dunder". IMO, it would make that section much easier to find if it
>> were to say either of:
>>
>> 1) System-defined names, also known as "dunder" names.
>> 2) System-defined names, informally known as "dunder" names.
>> 3) System-defined "dunder" names.
>>
>
> The word "dunder" was coined (relatively) recently. It was not in common
> use when those docs were written. Another common nickname is "magic
> methods".
>
> So that explains why the word "dunder" isn't in those docs. And those docs
> are pretty "formal" / "technical" anyway, not designed for the casual user
> to read.
>
> But yes, it would be good to add a bit of that text to make it more
> findable.
>
> I'd suggest you make a PR on the docs.
>
> -CHB
>
>
> Python Language Consulting
>   - Teaching
>   - Scientific Software Development
>   - Desktop GUI and Web Development
>   - wxPython, numpy, scipy, Cython
>
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/SAD4FIMQHP5PQI2X6X6KTZCF2L5AZMXG/
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to