Re: [PATCH] doc: Make asciidoc bullet items separate

From: Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
Date: Sep 7, 2026, 10:18 UTC
Message-ID: <9f455224-f156-493f-a21c-27a8922f3360@app.fastmail.com>
In-Reply-To: <20260907-maintenance-doc-bullet-fix-v1-1-dc08dbe61a82@brighamcampbell.com>

On Mon, Sep 7, 2026, at 09:15, Brigham Campbell wrote:

Show 28 quoted lines

> Fix conjoined bullet items in maintenance asciidoc file.
>
> Signed-off-by: Brigham Campbell <me@brighamcampbell.com>
> ---
>  Documentation/config/maintenance.adoc | 1 +
>  1 file changed, 1 insertion(+)
>
> diff --git a/Documentation/config/maintenance.adoc
> b/Documentation/config/maintenance.adoc
> index da8be9f812..c778ab09ac 100644
> --- a/Documentation/config/maintenance.adoc
> +++ b/Documentation/config/maintenance.adoc
> @@ -41,6 +41,7 @@ The possible strategies are:
>  This repacking strategy is a full replacement for the `gc` strategy
> and is
>  recommended for large repositories. This is the default strategy for
> manual
>  maintenance.
> ++
>  * `incremental`: This setting optimizes for performing small
> maintenance
>    activities that do not delete any data. This does not schedule the
> `gc`
>    task, but runs the `prefetch` and `commit-graph` tasks hourly, the
>
> ---
> base-commit: 3cb9185f65410273787f74333cc027d2ea5daada
> change-id: 20260907-maintenance-doc-bullet-fix-d351253f8a91

I wonder if this gives different results for asciidoc and asciidoctor.

• asciidoctor: seems that the bullet list is correct with or without
  this change (no change)
• asciidoc: needs this change

Note that I’ve made enough asciidoc/tor mistakes so I’m not that reliable of a witness.

I also idly wonder why git-scm renders this bullet list as it ought to. This hunk has not been modified for a while. The second paragraph which ostensibly made it conjoined was d9bccf2e (builtin/maintenance: introduce "geometric" strategy, 2025-10-24).

https://git-scm.com/docs/git-config