Terry J. Reedy <tjre...@udel.edu> added the comment:

The main issue I have with the existing doc is its use of 'top-level' to mean 
the main, initial, startup module that first executes the user code for a 
python 'program'.  We routinely use 'top-level' instead for the global scope of 
a module.  Example: https://docs.python.org/3/glossary.html, 'qualified name' 
entry, line 2: "For top-level functions and classes, ..."  Within '__main__', 
some code is top-level, but class and function bodies are not.

But this does not have to be part of this PR.

----------
nosy: +terry.reedy

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue39452>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to