[issue10434] Document the rules for "public names"

mike mcleod added the comment: I would like to help on this issue. Is there anyone available to push a PR through? If I make the changes. -- nosy: +mikecmcleod ___ Python tracker ___

[issue10434] Document the rules for "public names"

Nick Coghlan added the comment: PEP 8 now covers the developer side of things: http://www.python.org/dev/peps/pep-0008/#public-and-internal-interfaces A user facing counterpart describing our backwards compatibility policy is still desirable. Updating PEP 5 wouldn't go astray, since that's *su

[issue10434] Document the rules for "public names"

Changes by Barry A. Warsaw : -- nosy: +barry ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python

[issue10434] Document the rules for "public names"

Changes by Ezio Melotti : -- keywords: +easy type: -> enhancement versions: +Python 3.3, Python 3.4 ___ Python tracker ___ ___ Python

[issue10434] Document the rules for "public names"

Changes by Fred L. Drake, Jr. : -- nosy: +fdrake ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.py

[issue10434] Document the rules for "public names"

Changes by Ezio Melotti : -- nosy: +ezio.melotti ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.py

[issue10434] Document the rules for "public names"

Ron Adam added the comment: You may also want to update help topics. help("PRIVATENAMES"). Identifiers (Names) *** An identifier occurring as an atom is a name. See section *Identifiers and keywords* for lexical definition and section *Naming and binding* for documentation of

[issue10434] Document the rules for "public names"

Alexander Belopolsky added the comment: Michael Foord suggested adding the following to developer documentation such as PEP 8. [1] I am not sure PEP 8 is the right place for it. In my opinion, PEP 8 is mostly about stylistic choices that don't have a major impact on the users. In other word

[issue10434] Document the rules for "public names"

New submission from Alexander Belopolsky : As discussed in "Breaking undocumented API" thread [1] on python-dev, a definition of "public names" is buried deep in the language reference manual: """ The public names defined by a module are determined by checking the module’s namespace for a vari