![](https://secure.gravatar.com/avatar/baf7b66018bad189e6a60964f5618a1a.jpg?s=120&d=mm&r=g)
There have been a series of requests to enhance the current __main__.rst document <https://docs.python.org/3/library/__main__.html>: bpo-17359 <https://bugs.python.org/issue17359> bpo-24632 <https://bugs.python.org/issue24632> bpo-39452 <https://bugs.python.org/issue39452> So, I rewrote it! I went ahead and hosted it on my website for you all to easily take a look: https://jackdevries.com/pydoc__main__/library/__main__.html Of course, you can go directly to the GitHub PR instead: https://github.com/python/cpython/pull/26883 For reference, here is a link to the current document: https://docs.python.org/3/library/__main__.html This is a major change, so I'm thankful for anyone who can take the time to review it. I am a new cpython contributor, so advice for how to push this ahead is also welcome. For example, should I break this up into multiple PRs at this point? Thank you all!
![](https://secure.gravatar.com/avatar/5ce43469c0402a7db8d0cf86fa49da5a.jpg?s=120&d=mm&r=g)
On 2021-08-10 03:14, Jack DeVries wrote:
There have been a series of requests to enhance the current __main__.rst document <https://docs.python.org/3/library/__main__.html>:
bpo-17359 <https://bugs.python.org/issue17359> bpo-24632 <https://bugs.python.org/issue24632> bpo-39452 <https://bugs.python.org/issue39452>
So, I rewrote it! I went ahead and hosted it on my website for you all to easily take a look: https://jackdevries.com/pydoc__main__/library/__main__.html
Of course, you can go directly to the GitHub PR instead: https://github.com/python/cpython/pull/26883
For reference, here is a link to the current document: https://docs.python.org/3/library/__main__.html
This is a major change, so I'm thankful for anyone who can take the time to review it. I am a new cpython contributor, so advice for how to push this ahead is also welcome. For example, should I break this up into multiple PRs at this point?
Point of grammar: "Each of these mechanisms are related" should be "Each of these mechanisms is related". You might think that it's "are" because it follows "mechanisms", but it's "Each (something) is".
![](https://secure.gravatar.com/avatar/baf7b66018bad189e6a60964f5618a1a.jpg?s=120&d=mm&r=g)
Huh, distributive pronouns... you learn something every day: https://en.wikipedia.org/wiki/Distributive_pronoun I think I'm just going to change the word "each" to "both", though, because I don't like how "Each of these mechanisms is..." reads. Thank you for the catch @MRAB. On Tue, Aug 10, 2021 at 05:14:10PM +0100, MRAB wrote:
On 2021-08-10 03:14, Jack DeVries wrote:
There have been a series of requests to enhance the current __main__.rst document <https://docs.python.org/3/library/__main__.html>:
bpo-17359 <https://bugs.python.org/issue17359> bpo-24632 <https://bugs.python.org/issue24632> bpo-39452 <https://bugs.python.org/issue39452>
So, I rewrote it! I went ahead and hosted it on my website for you all to easily take a look: https://jackdevries.com/pydoc__main__/library/__main__.html
Of course, you can go directly to the GitHub PR instead: https://github.com/python/cpython/pull/26883
For reference, here is a link to the current document: https://docs.python.org/3/library/__main__.html
This is a major change, so I'm thankful for anyone who can take the time to review it. I am a new cpython contributor, so advice for how to push this ahead is also welcome. For example, should I break this up into multiple PRs at this point?
Point of grammar: "Each of these mechanisms are related" should be "Each of these mechanisms is related". You might think that it's "are" because it follows "mechanisms", but it's "Each (something) is". _______________________________________________ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-leave@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/NRV2NHID... Code of Conduct: http://python.org/psf/codeofconduct/
participants (2)
-
Jack DeVries
-
MRAB