On 14 Jun 2011, at 21:56, Dirkjan Ochtman wrote: > On Tue, Jun 14, 2011 at 19:13, Noah Slater <[email protected]> wrote: >>> +0 docbook >>> +1 REST >> >> Seriously, let's not fall into this trap. >> >> And let us not be seduced by so called "plain text" formats. >> >> We made this mistake on the book and I'm in no rush to repeat it. > > Sorry to contribute to the bikeshed, but I'm just going to get this > off my chest. > > From your email, this seems like a false generalization, at least, > going from AsciiDoc to all "plain text" formats. I don't know if > you've used reStructuredText, but it's seriously flexible and comes > with good (easily customizable) latex and html conversion out of the > box. I understand DocBook is awesome for print things, but experience > has also shown that DocBook has a significantly higher barrier to > entry.
On the lowest level, we will not require any DocBook knowledge. For the folks who want to make awesome docs, we should give them the best tools and I think we found a solution here. Cheers Jan --
