Re: [PATCH 1/2] doc: git-checkout: trivial callout cleanup

From: Junio C Hamano <gitster@pobox.com>
Date: Apr 25, 2023, 00:02 UTC
Message-ID: <xmqq8reg96cu.fsf@gitster.g>
In-Reply-To: <644684018a766_aba29424@chronos.notmuch>

Felipe Contreras <felipe.contreras@gmail.com> writes:

Show 8 quoted lines

> No, it's for the formatting machinery.
>
> The fact that both asciidoc and asciidoctor happen to understand our quircky
> formatting in this particualr situation doesn't mean it isn't quirky.
>
> In this particular case the parsers do understand what we are trying to do,
> because we just just pepper list continuations (`+`) everywhere and it happens
> to work.

I'll stop at pointing out that the first "no" sounds much stronger than the text that tries to substantiate it, which says that the machinery works fine without the changes.

> This discrepancy confused Jeff in [1].

And this is a good reason to add this change for humans.

> It's simply a good practice to follow the format asciidoctor documentation:

That one I would agree with 100%.

Thanks.