Re: WIP: asciidoc replacement

From: Sam Ravnborg <sam@ravnborg.org>
Date: Oct 3, 2007, 17:46 UTC
Message-ID: <20071003174659.GA13691@uranus.ravnborg.org>
In-Reply-To: <7vd4vwfou9.fsf@gitster.siamese.dyndns.org>

Hi Junio.

Show 9 quoted lines

> 
> In short, although I do appreciate Johannes's and Sam's attempt,
> I would really prefer to see us pick some externally maintained
> alternative, instead of inventing a homebrew system that we need
> to maintain ourselves.  It is rumored that git has much higher
> developer count vs loc count ratio than many other open source
> projects, doing the documentation format is not part of our
> project, and I'd rather see them spend time working on git, not
> building and maintaining AsciiDoc lookalike.

For the kernel I would like to see a tool that does:

o Based on nicely formatted ascii/utf-8 be able to:
 - Generate good looking and easy to read HTML
 - Possible generate other output formats too

And if the kernel folks do not like it then at least the possibility to run this on kbuild documentation locally so I can generate nice html docs for that part.

For a kernel integrated tool the dependencies shall be minimal which is where asciidoc fails today. If asciidoc people could address this issue for the simpler output format then the tool IMO would have a much stronger position.

Sam