couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Benoit Chesneau <bchesn...@gmail.com>
Subject Re: Docs, second try
Date Tue, 31 Jul 2012 13:39:02 GMT
On Tue, Jul 31, 2012 at 3:28 PM, Benoit Chesneau <bchesneau@gmail.com> wrote:
> 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 objections 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Ʈt

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

Mime
View raw message