Re: [PATCH 1/2] asciidoctor: fix user-manual to be built by `asciidoctor`

From: Jeff King <peff@peff.net>
Date: Jan 8, 2017, 03:27 UTC
Message-ID: <20170108032709.k43zmej5lxmcoj4o@sigill.intra.peff.net>
In-Reply-To: <xmqqbmvi34ul.fsf@gitster.mtv.corp.google.com>

On Sat, Jan 07, 2017 at 02:03:30PM -0800, Junio C Hamano wrote:

Show 9 quoted lines

> Is that a longer way to say that the claim "... is designed as a
> book" is false?
> 
> > So I dunno. I really do think "article" is conceptually the most
> > appropriate style, but I agree that there are some book-like things
> > (like appendices).
> 
> ... Yeah, I should have read forward first before starting to insert
> my comments.

To be honest, I'm not sure whether "book" versus "article" was really considered in the original writing. I think we can call it whichever produces the output we find most pleasing. I was mostly just pointing at there are some tradeoffs in the end result in flipping the type.

-Peff