[PATCH v5 5/5] doc: git-push: Add explanation of `git push origin main`

From: Julia Evans via GitGitGadget <gitgitgadget@gmail.com>
Date: Oct 6, 2025, 18:58 UTC
Message-ID: <ddeb8ecabe4ab30111b749dab3cb898ef41b4383.1759777131.git.gitgitgadget@gmail.com>
In-Reply-To: <pull.1964.v5.git.1759777131.gitgitgadget@gmail.com>

From: Julia Evans <julia@jvns.ca>

What happens if you run `git push` without any arguments is actually extremely complex to explain, as discussed in the previous commit.

But it's very easy to explain what `git push <remote> <branch>` does, so start the man page by explaining what that does.

The hope is that someone could just stop reading the man page here and never learn anything else about `git push`, and that would be fine.

Signed-off-by: Julia Evans <julia@jvns.ca>
---
 Documentation/git-push.adoc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/git-push.adoc b/Documentation/git-push.adoc
index aa01efcc0a..36bf1cc438 100644
--- a/Documentation/git-push.adoc
+++ b/Documentation/git-push.adoc
@@ -23,6 +23,10 @@ Updates one or more branches, tags, or other references in a remote
 repository from your local repository, and sends all necessary data
 that isn't already on the remote.
 
+The simplest way to push is `git push <remote> <branch>`.
+`git push origin main` will push the local `main` branch to the `main`
+branch on the remote named `origin`.
+
 The `<repository>` argument defaults to the upstream for the current branch,
 or `origin` if there's no configured upstream.

-- 
gitgitgadget