[Python-ideas] Re: Minor contributions to PEPs (Was: PEP 637 - support for indexing with keyword arguments)
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)
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)
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/