News for hackers. Stuff that matters.
Re:Ask HN: software for project documentation? by qznc on Wednesday November 13, 2013 @07:15AM (#6724686)
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/ [1] http://qznc.github.io/d-tut/

Re:Ask HN: software for project documentation? by mesec on Wednesday November 13, 2013 @08:44AM (#6725071)
+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/

Re:Ask HN: software for project documentation? by porker on Wednesday November 13, 2013 @10:39AM (#6725848)
Thanks!