This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author brandtbucher
Recipients brandtbucher, docs@python, emilyemorehouse, gvanrossum, miss-islington, shankarj67
Date 2020-03-07.22:15:24
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1583619324.85.0.294829810532.issue39868@roundup.psfhosted.org>
In-reply-to
Content
> I have created my draft with an example but I am confused about where exactly do I have to add the code and push it.

> I have cloned these two repositories in my system and setup everything:
> https://github.com/python/cpython
> https://github.com/python/devguide

Great! It's not necessary to clone the devguide though; CPython is the only one you're going to edit.

Make sure you've "forked" the repo on GitHub, and are working on a local clone of your fork. Otherwise things will be trickier.

> 1. Please tell me where I should be adding my code. Do I have to add code here https://github.com/python/cpython/blob/master/Doc/reference/expressions.rst and push it?

Yes, you'll add the new documentation to line 1652, where the "TODO" comment is. You should make the changes in your own fork of the repo, and push. Then you'll be ready for a PR.

> 2. I am working on the master branch only. Is there any specific branch I have to select?

Working from master in your own fork is fine, but frequent contributors often prefer to branch from master and work on those branches instead.

The pages I've linked to in the devguide walk you through every step of making a PR (including an intro on how to use Git). If it's easier for you, though, you can attach a copy of your edits to this issue and I can make a PR on your behalf. I just wouldn't count on repeating that workflow if you plan on contributing in the future; regular contributors should feel comfortable branching, committing, opening a PR, etc.
History
Date User Action Args
2020-03-07 22:15:24brandtbuchersetrecipients: + brandtbucher, gvanrossum, docs@python, emilyemorehouse, miss-islington, shankarj67
2020-03-07 22:15:24brandtbuchersetmessageid: <1583619324.85.0.294829810532.issue39868@roundup.psfhosted.org>
2020-03-07 22:15:24brandtbucherlinkissue39868 messages
2020-03-07 22:15:24brandtbuchercreate