[PATCH v3 0/4] doc: advertize gitdatamodel(1)

[kristofferhaugsbakk@fastmail.com]

From: Kristoffer Haugsbakk <code@khaugsbakk.name>

Topic name (applied): kh/doc-datamodel

Topic summary: gitdatamodel(7) is not linked to from anywhere. Let’s
mention it on other documentation pages and add a link to the glossary on
the data model page.

§ Testing

Testing done on v1. No tests done for v2 or v3.

§ Changes in v3

Thanks to Patrick and Julia for reviewing.

Following up on Julia’s review. See the interdiff/range diff and
patch notes. The patch notes also documents the changes from the
previous rounds by the way.

§ Link to v2

https://lore.kernel.org/git/V2_CV_doc_datamodel_advertize.c20@msgid.xyz/#t

§ Aside about context lines in gitlossary(7)

(see v1 & v2; no one commented on this)

[1/4] doc: git: list gitdatamodel(7) as a concept guide
[2/4] doc: git: link to the gitdatamodel(7) tutorial
[3/4] doc: glossary: link four of the terms to gitdatamodel(7)
[4/4] doc: datamodel: link to the glossary

 Documentation/git.adoc              | 12 ++++++++----
 Documentation/gitdatamodel.adoc     |  4 ++++
 Documentation/gitglossary.adoc      |  1 +
 Documentation/glossary-content.adoc | 13 ++++++++++---
 command-list.txt                    |  1 +
 5 files changed, 24 insertions(+), 7 deletions(-)

Interdiff against v2:
diff --git a/Documentation/gitdatamodel.adoc b/Documentation/gitdatamodel.adoc
index d588630e633..56b7635c199 100644
--- a/Documentation/gitdatamodel.adoc
+++ b/Documentation/gitdatamodel.adoc
@@ -24,8 +24,6 @@ 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.
-
 [[objects]]
 OBJECTS
 -------
Range-diff against v2:
1:  35832098717 = 1:  35832098717 doc: git: list gitdatamodel(7) as a concept guide
2:  3d8c4334785 = 2:  3d8c4334785 doc: git: link to the gitdatamodel(7) tutorial
3:  04802040a8d = 3:  04802040a8d doc: glossary: link four of the terms to gitdatamodel(7)
4:  5e8911beb4e ! 4:  ef9469244f2 doc: datamodel: link to the glossary
    @@ Commit message
         Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
     
      ## Documentation/gitdatamodel.adoc ##
    -@@ Documentation/gitdatamodel.adoc: 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.
    -+
    - [[objects]]
    - OBJECTS
    - -------
     @@ Documentation/gitdatamodel.adoc: $ git reflog main --date=iso --no-decorate
      4ccb6d7 main@{2025-09-29 15:16:48 -0400}: commit (initial): Initial commit
      ----

base-commit: e9019fcafe0040228b8631c30f97ae1adb61bcdc
-- 
2.55.0.13.g335083658c8