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

Re: [PATCH v2 4/4] doc: datamodel: link to the glossary

From
Julia Evans <julia@jvns.ca>
Date
Sep 2, 2026, 13:32 UTC
Message-ID
<954865cf-5984-4e0d-9e8c-7c874896a1f2@app.fastmail.com>
In-Reply-To
<V2_datam_to_glossary.c24@msgid.xyz>
On Sun, Aug 23, 2026, at 7:32 AM, kristofferhaugsbakk@fastmail.com wrote:
Show 29 quoted lines
> From: Kristoffer Haugsbakk <code@khaugsbakk.name>
>
> We linked from the glossary to the data model page in the last commit.
> It can also be useful to link the other way for readers who might want
> to reference more terminology.
>
> Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
> ---
>
> Notes (series):
>     v1:
>     But: maybe the See Also link is enough here?
>    
>     > a comprehensive terminology reference
>    
>     This is descriptive or aspirational. Either works.
>
>  Documentation/gitdatamodel.adoc | 6 ++++++
>  1 file changed, 6 insertions(+)
>
> diff --git a/Documentation/gitdatamodel.adoc b/Documentation/gitdatamodel.adoc
> index dcfdff0346f..d588630e633 100644
> --- a/Documentation/gitdatamodel.adoc
> +++ b/Documentation/gitdatamodel.adoc
> @@ -24,6 +24,8 @@ Git's core operations use 4 kinds of data:
>  3. <<index,The index>>, also known as the staging area
>  4. <<reflogs,Reflogs>>: logs of changes to references ("ref log")
> 
> +See linkgit:gitglossary[7] for a comprehensive terminology reference.

I'd prefer to put this in SEE ALSO instead. Also "comprehensive terminology reference" might be a bit aspirational like you say. Maybe just "terminology reference"?

Thanks for adding these links! 
- Julia
Previous: kristofferhaugsbakk@fastmail.comNext: Kristoffer Haugsbakk
Message 14 of 23 in “doc: advertize gitdatamodel(1)”
  1. 0/4 doc: advertize gitdatamodel(1)kristofferhaugsbakk@fastmail.com, Aug 20, 2026
  2. 1/4 doc: git: list gitdatamodel(7) as a concept guidekristofferhaugsbakk@fastmail.com, Aug 20, 2026
  3. Patrick SteinhardtAug 21, 2026
  4. 2/4 doc: git: link to the gitdatamodel(7) tutorialkristofferhaugsbakk@fastmail.com, Aug 20, 2026
  5. Patrick SteinhardtAug 21, 2026
  6. Kristoffer HaugsbakkAug 21, 2026
  7. 3/4 doc: glossary: link four of the terms to gitdatamodel(7)kristofferhaugsbakk@fastmail.com, Aug 20, 2026
  8. 4/4 doc: datamodel: link to the glossarykristofferhaugsbakk@fastmail.com, Aug 20, 2026
  9. 0/4 doc: advertize gitdatamodel(1)kristofferhaugsbakk@fastmail.com, Aug 23, 2026
  10. 1/4 doc: git: list gitdatamodel(7) as a concept guidekristofferhaugsbakk@fastmail.com, Aug 23, 2026
  11. 2/4 doc: git: link to the gitdatamodel(7) tutorialkristofferhaugsbakk@fastmail.com, Aug 23, 2026
  12. 3/4 doc: glossary: link four of the terms to gitdatamodel(7)kristofferhaugsbakk@fastmail.com, Aug 23, 2026
  13. 4/4 doc: datamodel: link to the glossarykristofferhaugsbakk@fastmail.com, Aug 23, 2026
  14. Julia EvansSep 2, 2026
  15. Kristoffer HaugsbakkSep 2, 2026
  16. Julia EvansSep 2, 2026
  17. Patrick SteinhardtAug 31, 2026
  18. Kristoffer HaugsbakkSep 2, 2026
  19. 0/4 doc: advertize gitdatamodel(1)kristofferhaugsbakk@fastmail.com, Sep 5, 2026
  20. 1/4 doc: git: list gitdatamodel(7) as a concept guidekristofferhaugsbakk@fastmail.com, Sep 5, 2026
  21. 2/4 doc: git: link to the gitdatamodel(7) tutorialkristofferhaugsbakk@fastmail.com, Sep 5, 2026
  22. 3/4 doc: glossary: link four of the terms to gitdatamodel(7)kristofferhaugsbakk@fastmail.com, Sep 5, 2026
  23. 4/4 doc: datamodel: link to the glossarykristofferhaugsbakk@fastmail.com, Sep 5, 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.