Re: [PATCH 1/4] doc: git-push: update intro

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 28, 2025, 16:18 UTC
Message-ID: <xmqqtt1rwhbf.fsf@gitster.g>
In-Reply-To: <CALnO6CCca2Yp7K16ShqUaZNN_POv106qyXfKq1aJMyXhA+EyCw@mail.gmail.com>

"D. Ben Knoble" <ben.knoble@gmail.com> writes:

Show 14 quoted lines

>> +Updates one or more branches, tags, or other references in a remote
>> +repository from your local repository.
>
> Considering the glossary entry[1] is for "ref", not "reference", what about
>
> (a) linking to the glossary (is this possible?), and/or
> (b) saying something like
>
>     Updates one or more branches, tags, or other references (called "refs")…
>
> ?
>
> [1]: "git help glossary", or
> https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-ref

Both sound good ideas. We should make sure that readers are aware of the glossary by linking into it from more places.

$ 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.