On Thu, Sep 19, 2013 at 11:59 AM, Dirkjan Ochtman <dirkjan@xxxxxxxxxx> wrote: > On Thu, Sep 19, 2013 at 11:07 AM, Martin Sustrik <sustrik@xxxxxxxxxx> wrote: >>> Personally, I like Sphinx quite a bit. How about setting up a Sphinx >>> project that has both the reference docs and more guide- or >>> tutorial-like documentation? >> >> Any specific reason for using Sphinx over Asciidoc (given that Asciidoc >> toolchain is already part of the build process)? > > I don't have a lot of experience with Asciidoc, but the web output > seems fairly plain. I think Sphinx has better-looking and more > functional web output as well as man page output, latex and PDF output > options. reST also is easy to write and more of a standard, I think, > than whatever is used for asciidoc? Both can be made nice with theming, Sphinx default theme is a bit nice IMHO. (reST and Asciidoc aren't much different btw) lu