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 21:22:40 GMT
On Tue, Jul 31, 2012 at 10:23 PM, Dirkjan Ochtman <dirkjan@ochtman.nl> wrote:
> I've converted the docs into reST + Sphinx here (via Pandoc):
>
> https://github.com/djco/couchdb/tree/docs/share/docs/sphinx-docs
> http://couchdb.readthedocs.org/en/latest/
>
> This needs a little more reordering and structuring, but I think it
> looks pretty good already.
>
> I'd be happy to work on this more so it'll be a good resource before
> the next release.
>
> Cheers,
>
> Dirkjan

That's awesome. I like it :) Thanks!

I guess we could try some custom module later on a second pass, like this one :

http://packages.python.org/sphinxcontrib-httpdomain/

But current result is enough by itself. I guess we could reuse the
makefile provided with sphinx and integrate it in our sources too.
Then last piece of work is adding a custom --generate-doc option to
autotools :)

- benoit

Mime
View raw message