[PATCH] doc: clarify push.default=simple in triangular workflows
- From
- Ivan Baluta via GitGitGadget <gitgitgadget@gmail.com>
- Date
- May 22, 2026, 06:58 UTC
- Message-ID
- <pull.2115.git.1779433093971.gitgitgadget@gmail.com>
From: ivanbaluta <ivanbaluta.dev@gmail.com>
The documentation for 'simple' push mode currently focuses on the centralized workflow. However, the implementation in builtin/push.c falls back to 'current' behavior when pushing to a remote different from the upstream (a triangular workflow).
Clarify this in the manual to align the documentation with the long-standing implementation and prevent user confusion.
Signed-off-by: ivanbaluta <ivanbaluta.dev@gmail.com>
---
doc: clarify push.default=simple in triangular workflowsPublished-As: https://github.com/gitgitgadget/git/releases/tag/pr-2115%2Fivanbaluta%2Fdoc-push-simple-triangular-v1 Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-2115/ivanbaluta/doc-push-simple-triangular-v1 Pull-Request: https://github.com/gitgitgadget/git/pull/2115
Documentation/config/push.adoc | 3 +++ 1 file changed, 3 insertions(+)
diff --git a/Documentation/config/push.adoc b/Documentation/config/push.adoc index d9112b2260..979e40c3a4 100644 --- a/Documentation/config/push.adoc +++ b/Documentation/config/push.adoc @@ -45,6 +45,9 @@ If you are working on a centralized workflow (pushing to the same repository you pull from, which is typically `origin`), then you need to configure an upstream branch with the same name. + +In a triangular workflow (pushing to a remote different from the upstream), +`simple` behaves like `current`. ++ This mode is the default since Git 2.0, and is the safest option suited for beginners. base-commit: 59ff4886a579f4bc91e976fe18590b9ae02c7a08
-- gitgitgadget