From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 28 Aug 2025 16:18:28 GMT
Subject: Re: [PATCH 1/4] doc: git-push: update intro
Message-ID: <xmqqtt1rwhbf.fsf@gitster.g>
In-Reply-To: <CALnO6CCca2Yp7K16ShqUaZNN_POv106qyXfKq1aJMyXhA+EyCw@mail.gmail.com>

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

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