couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jan Lehnardt <...@apache.org>
Subject Re: [Couchdb Wiki] Trivial Update of "CouchDB_in_the_wild" by wentforgold
Date Tue, 14 Jun 2011 20:05:28 GMT

On 14 Jun 2011, at 21:56, Dirkjan Ochtman wrote:

> On Tue, Jun 14, 2011 at 19:13, Noah Slater <nslater@apache.org> 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
-- 



Mime
View raw message