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!
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".
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