Re: [PATCH] Doc: fix misleading asciidoc formating

[Jeff King <peff@peff.net>]

On Tue, Mar 05, 2019 at 06:02:27PM -0500, Jeff King wrote:

> On Wed, Mar 06, 2019 at 07:54:20AM +0900, Junio C Hamano wrote:
> 
> > Jeff King <peff@peff.net> writes:
> > 
> > > Did you notice this when building locally, or on the asciidoctor-built
> > > pages at git-scm.com?
> > 
> > Does git-scm.com even have this file rendered?  I do not think we
> > glob for technical/*.txt in any of our Makefiles; instead we have a
> > list of ready-to-be-consumed TECH_DOCS listed explicitly.
> 
> It is rendered, at https://git-scm.com/docs/directory-rename-detection.

By the way, that rendering shows that the whole document could probably
use a few tweaks to make its asciidoc formatting look good (in addition
to the "x." thing that Jean-Noël fixed here, which can also be seen
there).

TBH, I still have mixed feelings on rendering these technical docs with
asciidoc at all. It seems like few enough people bother to render them
that bugs persist for a long time. It kind of seems like make-work
getting them to format correctly.

-Peff