[docs] [issue17383] Error in documentation /2/tutorial/modules.html#more-on-modules
report at bugs.python.org
Fri Mar 8 17:02:29 CET 2013
Jeff Knupp added the comment:
I think Piotr's point is the wording of the last sentence is ambiguous. The second statement reads "It is customary *but not required* to place all import statements at the beginning of a module...". The third seems to state that regardless of whether or not you followed the custom, module names are always placed in the global symbol table.
I think the last two sentences need to be rewritten to remove ambiguity. If, at this point, we only want to explain that importing a module makes that modules names available then that's what the documentation should say (even more so if the term "symbol table" hasn't been introduced yet, which would effectively render the entire block useless).
Python tracker <report at bugs.python.org>
More information about the docs