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 <p...@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
