Re: [PATCH 2/2] doc: add new Git tutorial for beginners

["Julia Evans" <julia@jvns.ca>]

On Wed, Oct 21, 2026, at 1:16 PM, Junio C Hamano wrote:
> Junio C Hamano <gitster@pobox.com> writes:
>
>> ... indeed, that is how I caught a handful of mistakes over the
>> course of this project that I suspect I otherwise wouldn't have
>> found.  Once found, however, such a mistake is easier to
>> correct.
>
> Sorry, but re-reading my previous message, I realize my preference
> was not very clear.  The last sentence there should have ended
> with "easier to correct with the ATX-style prefix format."
>
> I do not have a strong preference either way myself.  However, this
> is practically a brand-new document.  If you think it would be
> easier to adopt and stay consistent with the prefix format, I am
> happy to go with that direction.

I do find it easier to stay consistent with the prefix format, but
I also ran into an issue where if I format the DESCRIPTION section
like this:

== DESCRIPTION

then I get this error from `make lint-docs`:

gittutorial.adoc:779: has no required 'DESCRIPTION' section!

So it seems easier for now to stick to the usual format, since
it feels weird to me to mix two different ways of formatting
headings in the same document, and I don't want to update
the linter to understand the other way of formatting headings.