Subject: Re: [PATCH] doc: add a explanation of Git's data model

From: Junio C Hamano <[email-masked]>
Date: Sun, 05 Oct 2025 20:32:56 -0700

"Julia Evans via GitGitGadget" <[email-masked]> writes:

> +MAN7_TXT += gitdatamodel.adoc
>  MAN7_TXT += gitdiffcore.adoc
> ...
> +gitdatamodel(7)
> +===============
> +
> +NAME
> +----
> +gitdatamodel - Git's core data model
> +
> +DESCRIPTION
> +-----------

The above causes doc-lint to barf.

https://github.com/git/git/actions/runs/18265502271/job/51999236907#step:4:655

gitdatamodel.adoc:226: has no required 'SYNOPSIS' section!
    LINT MAN SEC giteveryday.adoc
make[1]: *** [Makefile:498: .build/lint-docs/man-section-order/gitdatamodel.ok] Error 1

You can check locally with "make check-docs" without waiting for my
integration cycle to push to GitHub CI.

Thanks.