From: Julia Evans Date: Wed, 21 Oct 2026 21:24:37 GMT Subject: Re: [PATCH 2/2] doc: add new Git tutorial for beginners Message-ID: <25e3db8e-b011-4af4-99ff-5ecb840e92d2@app.fastmail.com> In-Reply-To: On Wed, Oct 21, 2026, at 1:16 PM, Junio C Hamano wrote: > Junio C Hamano 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.