[Python-ideas] Re: Minor contributions to PEPs (Was: PEP 637 - support for indexing with keyword arguments)

2020-09-23 Thread 2QdxY4RzWzUUiLuE
On 2020-09-23 at 23:28:11 +0100,
Henk-Jaap Wagenaar  wrote:

> >>> a[3]   # returns the fourth element of a
> 
> has the comment unfinished. I guess it should say list or something
> similar.]

Yes, I agree:  it looks like it's broken, but it's okay.  a[3] returns
the fourth element of a sequence named "a."  If the sequence were named
something_descriptive, then something_descriptive[3] returns the fourth
element of a sequence named "something_descriptive."
___
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/Z5JPXAIDPBMTNREXDNEX54N7J3PZ7OLJ/
Code of Conduct: http://python.org/psf/codeofconduct/


[Python-ideas] Re: Minor contributions to PEPs (Was: PEP 637 - support for indexing with keyword arguments)

2020-09-23 Thread Christopher Barker
And here:

https://github.com/python/peps/blob/master/pep-0637.txt

is the source to look at -- and the repo to do a PR against.

-CHB


On Wed, Sep 23, 2020 at 3:34 PM Chris Angelico  wrote:

> On Thu, Sep 24, 2020 at 8:29 AM Henk-Jaap Wagenaar
>  wrote:
> >
> > I noticed a sentence that was not completed in PEP 637. Though I have
> made (pretty minor) contributions to CPython and some other things, it
> isn't entirely clear to me whether it would be appropriate for me to submit
> an issue or pull request for this, and what the general policy is?
> >
> > https://github.com/python/peps/blob/master/CONTRIBUTING.rst does not
> make it any clearer to me, I guess it is kinda the Wild West and depends on
> the PEP/what the change is? Would it be worth clarifying this?
> >
> >
> > Secondly, I wasn't 100% sure this make was a rendering mistake or in the
> source. Would it be possible/an idea to include a link to the source (like
> the Python documentation does)?
> >
> > [I am sure people will be curious what the mistake was:
> >
> > >>> a[3]   # returns the fourth element of a
> >
> > has the comment unfinished. I guess it should say list or something
> similar.]
> >
>
> Actually it's returning the fourth element of "the thing in the
> variable named 'a'", so it's not the English article. If you feel
> that's unclear, you could propose a change that renames the variable,
> perhaps.
>
> Pull requests are absolutely appropriate for simple changes,
> copyediting, etc. You'll be asked to sign the licensing agreement, but
> for extremely tiny changes (say, just fixing a missed bit of
> punctuation), we can override the CLA bot and merge the change anyway.
>
> ChrisA
> ___
> Python-ideas mailing list -- python-ideas@python.org
> To unsubscribe send an email to python-ideas-le...@python.org
> https://mail.python.org/mailman3/lists/python-ideas.python.org/
> Message archived at
> https://mail.python.org/archives/list/python-ideas@python.org/message/IXZOMRI45NLGUR25K2NNHNVP4YIJMYS4/
> Code of Conduct: http://python.org/psf/codeofconduct/
>


-- 
Christopher Barker, PhD

Python Language Consulting
  - Teaching
  - Scientific Software Development
  - Desktop GUI and Web Development
  - wxPython, numpy, scipy, Cython
___
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/QC7GEXP63L2VIR3BWPZSOPFCZNSFRQXY/
Code of Conduct: http://python.org/psf/codeofconduct/


[Python-ideas] Re: Minor contributions to PEPs (Was: PEP 637 - support for indexing with keyword arguments)

2020-09-23 Thread Chris Angelico
On Thu, Sep 24, 2020 at 8:29 AM Henk-Jaap Wagenaar
 wrote:
>
> I noticed a sentence that was not completed in PEP 637. Though I have made 
> (pretty minor) contributions to CPython and some other things, it isn't 
> entirely clear to me whether it would be appropriate for me to submit an 
> issue or pull request for this, and what the general policy is?
>
> https://github.com/python/peps/blob/master/CONTRIBUTING.rst does not make it 
> any clearer to me, I guess it is kinda the Wild West and depends on the 
> PEP/what the change is? Would it be worth clarifying this?
>
>
> Secondly, I wasn't 100% sure this make was a rendering mistake or in the 
> source. Would it be possible/an idea to include a link to the source (like 
> the Python documentation does)?
>
> [I am sure people will be curious what the mistake was:
>
> >>> a[3]   # returns the fourth element of a
>
> has the comment unfinished. I guess it should say list or something similar.]
>

Actually it's returning the fourth element of "the thing in the
variable named 'a'", so it's not the English article. If you feel
that's unclear, you could propose a change that renames the variable,
perhaps.

Pull requests are absolutely appropriate for simple changes,
copyediting, etc. You'll be asked to sign the licensing agreement, but
for extremely tiny changes (say, just fixing a missed bit of
punctuation), we can override the CLA bot and merge the change anyway.

ChrisA
___
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/IXZOMRI45NLGUR25K2NNHNVP4YIJMYS4/
Code of Conduct: http://python.org/psf/codeofconduct/