+cc Junio due to his reply to my reply On Thu, Aug 28, 2025 at 1:48 PM Julia Evans <julia@xxxxxxx> 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
