From: D. Ben Knoble <ben.knoble@gmail.com>
Date: Thu, 28 Aug 2025 19:39:12 GMT
Subject: Re: [PATCH 1/4] doc: git-push: update intro
Message-ID: <CALnO6CC4e_CY+D7_d151dyZQS5t6ukEgkyMH=qy39ZPttSPOvA@mail.gmail.com>
In-Reply-To: <4d9caee9-973a-4d41-b6cf-d399a238942b@app.fastmail.com>

+cc Junio due to his reply to my reply

On Thu, Aug 28, 2025 at 1:48 PM Julia Evans <julia@jvns.ca> wrote:
>
> > Considering the glossary entry[1] is for "ref", not "reference", what about
> >
> > (a) linking to the glossary (is this possible?), and/or
>
> I like this idea. Over on the HTML docs side
> (https://github.com/git/git-scm.com/pull/2040)
> I've been working on a way to show an interactive tooltip from the glossary when
> people hover over "jargon" terms. The goal there is to make the glossary a lot
> more discoverable.
>
> Right now it only works for terms inside angle brackets (like `<ref>`), but
> I've been thinking of adding a `linkgitglossary:` AsciiDoc macro or something
> (similar to `linkgit:`) to link terms to specific glossary entries. It's hard
> to tell what that should do in the terminal version of the man pages
> (maybe nothing!), but it could make the HTML versions a lot easier to use.

I think we could so similar to existing "linkgit:" and expand to
"gitglossary(7)" (or "git help glossary")

-- 
D. Ben Knoble