Skip to content

Commit 9681b7d

Browse files
Clarify first push instructions (#261)
Co-authored-by: Malcolm Smith <smith@chaquo.com>
1 parent dc1be42 commit 9681b7d

1 file changed

Lines changed: 7 additions & 3 deletions

File tree

  • src/beeware_docs_tools/shared_content/en/_shared/contribute/how

src/beeware_docs_tools/shared_content/en/_shared/contribute/how/submit-pr.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ The following shows an example of what to expect on `push`, with the URL highlig
166166
{% endif %}
167167

168168
```console {hl_lines="11"}
169-
(.venv) $ git push
169+
(.venv) $ git push --set-upstream origin
170170
Enumerating objects: 15, done.
171171
Counting objects: 100% (15/15), done.
172172
Delta compression using up to 24 threads
@@ -189,7 +189,7 @@ To https://github.com/<your GitHub username>/{{ formal_name }}.git
189189
/// tab | Linux
190190

191191
```console {hl_lines="11"}
192-
(.venv) $ git push
192+
(.venv) $ git push --set-upstream origin
193193
Enumerating objects: 15, done.
194194
Counting objects: 100% (15/15), done.
195195
Delta compression using up to 24 threads
@@ -210,7 +210,7 @@ To https://github.com/<your GitHub username>/{{ formal_name }}.git
210210
/// tab | Windows
211211

212212
```doscon {hl_lines="11"}
213-
(.venv) C:\...>git push
213+
(.venv) C:\...>git push --set-upstream origin
214214
Enumerating objects: 15, done.
215215
Counting objects: 100% (15/15), done.
216216
Delta compression using up to 24 threads
@@ -230,6 +230,10 @@ To https://github.com/<your GitHub username>/{{ formal_name }}.git
230230

231231
{% endif %}
232232

233+
The `--set-upstream` option tells Git to connect your local branch to the branch on your GitHub fork. You only need to include it the first time you push a new branch; after that, you can use `git push`.
234+
235+
If GitHub asks for a password, don't enter your GitHub account password. GitHub no longer accepts account passwords for Git operations over HTTPS; follow GitHub's instructions for [creating and using a personal access token](https://docs.github.com/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) instead.
236+
233237
If you've previously pushed the current branch to GitHub, you won't receive the URL again. However, there are other ways to get to the PR creation URL:
234238

235239
- Navigate to the upstream repository, click on "Pull Requests" followed by "New pull request", and choose the from which you want to submit your pull request.

0 commit comments

Comments
 (0)