git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] doc: clarify push.default=simple in triangular workflows

From
Junio C Hamano <gitster@pobox.com>
Date
May 22, 2026, 08:49 UTC
Message-ID
<xmqq8q9bu8vf.fsf@gitster.g>
In-Reply-To
<pull.2115.git.1779433093971.gitgitgadget@gmail.com>
"Ivan Baluta via GitGitGadget" <gitgitgadget@gmail.com> writes:
> From: ivanbaluta <ivanbaluta.dev@gmail.com>

Just noticing, but don't you want to spell your name just like you spell it in your e-mails? I.e.,

    From: Ivan Baluta <ivanbaluta.dev@gmail.com>
Use the same name for your sign-off below.
> 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).

It is not just implementation, but that is how it was designed to do.

Whether centralized or triangular, "simple" works as a restricted form as "current", with the same restriction. That is, both "current" and "simple" push out only the current branch to a single destination that is configured, and "simple" insists that the destination has the same name as the local branch.

So I am not sure if this three-line patch adds much value.

I agree that it _is_ confusing that the current text singles out the centralized workflow when describing "simple". But the remedy may not be to add "what happens in triangular, then?", but it may be to clarify that the need to configure the push destination whether your push destination is the same as or different from your upstream, no?

Something along this line, perhaps?
    `simple`;;
    push the current branch with the same name on the remote.
    +
    This mode requires that the remote repository to be pushed to is
    known.  When pushing back to the same remote you pull from, the
    current branch must also have an upstream tracking branch with the
    same name.
    +
    This mode is the default since Git 2.0, and is the safest option
    suited for beginners.

That way, the description would be more self standing and the readers hopefully do not have to refer to another mode (`current`) to understand what happens, no?

Previous: Ivan Baluta via GitGitGadgetNext: Иван Балута
Message 2 of 5 in “doc: clarify push.default=simple in triangular workflows”
  1. doc: clarify push.default=simple in triangular workflowsIvan Baluta via GitGitGadget, May 22, 2026
  2. Junio C HamanoMay 22, 2026
  3. Иван БалутаMay 25, 2026
  4. doc: clarify push.default=simple behaviorIvan Baluta via GitGitGadget, May 26, 2026
  5. Junio C HamanoJun 1, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.