[issue24632] Improve documentation about __main__.py

[Irit Katriel]

Change by Irit Katriel <iritkatriel at gmail.com>:


----------
versions: +Python 3.11 -Python 2.7, Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24632>
_______________________________________