Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: pass (nike.apache.org: domain of bchesneau@gmail.com designates
 74.125.83.52 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CAJNb-9ozBHXK8t9neyr-K=9dQA9TvKPQpyX5Lp0Ss4Sqq_8mWA@mail.gmail.com>
References: <EC73BB16-F86A-4F6B-9143-A22B88381108@apache.org>
	<8A69B3F1-C955-4127-B92B-B0DA1AA9AEB6@apache.org>
	<19EB8367-1282-4406-9C51-B3AE4AFA0080@apache.org>
	<D5FEC7AA-2294-41F5-81E9-AF982BF29976@apache.org>
	<2E5C3210-58B9-48A7-9E21-3B6206D24899@apache.org>
	<382956416E9B4787895A95D59AC5ECC1@cloudant.com>
	<70658AB3-81FA-4E3A-ABE6-D6299ED2704A@apache.org>
	<E2D5A5F1B3794024BBEC5AD03852711F@cloudant.com>
	<436CC93B-6244-4A01-9933-46B2937AB331@apache.org>
	<FF69394627DB40C0BFE9CBC7AE253631@cloudant.com>
	<872CBFC9-B758-492C-8297-410600E6DA84@tumbolia.org>
	<BD8ECF010F6E41C4A5F69DA433E09A6C@cloudant.com>
	<CAHZBNKb-+V6qn=eNnmKyLTZfh32QvFj=CnY_JPHdm3s--dBzLw@mail.gmail.com>
	<CAJNb-9rMGryj13gLJXqcmirc-6kRjNjT9YocCmyFmfcuipO4OQ@mail.gmail.com>
	<15663FC5-C39A-480E-90F3-DE29A90B51CC@apache.org>
	<CAJNb-9ozBHXK8t9neyr-K=9dQA9TvKPQpyX5Lp0Ss4Sqq_8mWA@mail.gmail.com>
Date: Tue, 31 Jul 2012 15:39:02 +0200
Message-ID: 
 <CAJNb-9qOs_TUdO-qboXTAyyGJ2vCNerf3ZHPmMCSz0mungpWqw@mail.gmail.com>
Subject: Re: Docs, second try
From: Benoit Chesneau <bchesneau@gmail.com>
To: dev@couchdb.apache.org
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On Tue, Jul 31, 2012 at 3:28 PM, Benoit Chesneau <bchesneau@gmail.com> wrot=
e:
> On Tue, Jul 31, 2012 at 3:22 PM, Robert Newson <rnewson@apache.org> wrote=
:
>>
>> I dislike a veto without an adequate reason. Can you make your objection=
s explicit? What can't we do (that we need) with Markdown?
>
> I gave some:
>>>[..]  There is no real doc system in markdown which will
>>> force to write another script and we will lost some features given by
>>> docbook (linking, references...)
>>>
>
> linking, automatic references, templating. specific section markups ...
> the need to write this tool to generate the doc while we could reuse a
> widely used tool wich is important for me. Also with sphinx you could
> still generate a PDF or event an ebook which is imo important for
> those who want to consult the doc offline.
>
> - beno=EEt

To be clear, this not about markdown, this is more because there I
don't know any good documentation tool using this format. If some
exist, then let's go, but I  think we should try to use the tool most
know to encourage people to help us to improve and write the
documentation.

- benoit