3 ms·
I like Sphinx [0]. For example, I used it for this D tutorial [1]. I do not like wikis or cms, because I like my documentation in a version control system. [0]
by qznc 13y ago
I like Sphinx [0]. For example, I used it for this D tutorial [1].
I do not like wikis or cms, because I like my documentation in a version control system.
[0] http://sphinx-doc.org/ http://sphinx-doc.org/
[1] http://qznc.github.io/d-tut/ http://qznc.github.io/d-tut/
- mesec 13y ago+1 for Sphinx. For me, it's crucial that code and documentation are kept closely together. As in, changes to the code and the related documentation go in the same commit. In my experience, that's the only way to keep them in sync. Sphinx works great in this scenario, can output the docs in many different formats, default HTML output has search built-in etc. It's cross-platform (although I've used it on Windows and Linux only, I'm pretty sure it works on Macs as well). This is good stuff, too: http://johnmacfarlane.net/pandoc/ http://johnmacfarlane.net/pandoc/
- porker 13y agoThanks!