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/