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