[issue46279] [docs] Minor information-ordering issue in __main__ doc

Change by Alex Waygood : -- type: -> behavior ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue46279] [docs] Minor information-ordering issue in __main__ doc

FeRD (Frank Dana) added the comment: Readding Tal to the nosy list, since my previous comment was inadvertently accompanied by an eviction! (Sorry about that.) -- nosy: +taleinat ___ Python tracker

[issue46279] [docs] Minor information-ordering issue in __main__ doc

Jackson Brummell added the comment: Have updated the PR to be in line with the issues leading ideas, specifically Tal's suggestion. Thanks -- ___ Python tracker ___

[issue46279] [docs] Minor information-ordering issue in __main__ doc

FeRD (Frank Dana) added the comment: Maybe, """ This won’t work for __main__.py files in the root directory of a .zip file though. Thus, for consistency, it is usually preferred to place code in other modules. That code can then be invoked from a minimal ``__main__.py``. """ (And then the

[issue46279] [docs] Minor information-ordering issue in __main__ doc

Tal Einat added the comment: I agree that it seems better to avoid menntioning venv in that sentence. Specifically I suggest: This won’t work for __main__.py files in the root directory of a .zip file though. Hence, for consistency, minimal __main__.py without a __name__ check are

[issue46279] [docs] Minor information-ordering issue in __main__ doc

FeRD (Frank Dana) added the comment: TBH, personally I don't think I'd just reword it with "below". That seems like the path of least resistance, but then the sentence becomes this: """ This won’t work for __main__.py files in the root directory of a .zip file though. Hence, for consistency,

[issue46279] [docs] Minor information-ordering issue in __main__ doc

Jackson Brummell added the comment: Updating issue, Have submitted fix -- ___ Python tracker ___ ___ Python-bugs-list mailing list

[issue46279] [docs] Minor information-ordering issue in __main__ doc

Change by Jackson Brummell : -- keywords: +patch pull_requests: +28683 stage: -> patch review pull_request: https://github.com/python/cpython/pull/30480 ___ Python tracker

[issue46279] [docs] Minor information-ordering issue in __main__ doc

Jackson Brummell added the comment: It seems this is a simple miswording, where the word 'above' is used when the see below example clarifies BELOW the text. I will create a pull request within the hour -- nosy: +jacksonbrummell1 ___ Python

[issue46279] [docs] Minor information-ordering issue in __main__ doc

Éric Araujo added the comment: Do you have a suggestion on how to fix this? -- nosy: +eric.araujo ___ Python tracker ___ ___

[issue46279] [docs] Minor information-ordering issue in __main__ doc

Change by Irit Katriel : -- keywords: +easy ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue46279] [docs] Minor information-ordering issue in __main__ doc

New submission from FeRD (Frank Dana) : The expanded documentation on top-level environments is quite an improvement, but there's one passage that causes some confusion. In the section '__main__.py in Python Packages', towards the end, it reads: """ This won’t work for __main__.py files in