[Python-Dev] Re: New __main__.rst

[Jack DeVries]

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 :
> > 
> > bpo-17359 
> > bpo-24632 
> > bpo-39452 
> > 
> > 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-le...@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/NRV2NHID465FGCMPHHLT7KS6WEOFSOU3/
> Code of Conduct: http://python.org/psf/codeofconduct/
___
Python-Dev mailing list -- python-dev@python.org
To unsubscribe send an email to python-dev-le...@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/WIRGGAYNSD2YTX3WQRZL6JO7E3UMH6N3/
Code of Conduct: http://python.org/psf/codeofconduct/

[Python-Dev] Re: New __main__.rst

[MRAB]

On 2021-08-10 03:14, Jack DeVries wrote:

There have been a series of requests to enhance the current __main__.rst
document :

bpo-17359 
bpo-24632 
bpo-39452 

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-le...@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/NRV2NHID465FGCMPHHLT7KS6WEOFSOU3/
Code of Conduct: http://python.org/psf/codeofconduct/