News for hackers. Stuff that matters.
Re:Ask HN: What do you use to produce software documentation? by dochtman on Friday June 14, 2013 @06:11AM (#5879124)
I like to use [Sphinx](http://sphinx-doc.org/), stored in the project repository.

It uses reStructuredText (which is more extensible than Markdown) and was written for the Python documentation.

Re:Ask HN: What do you use to produce software documentation? by LukaszB on Friday June 14, 2013 @06:23AM (#5879150)
How about the situation when the documentation has to be prepared before any of implementation or coding starts (initial requirements, qc etc.) ?
Re:Ask HN: What do you use to produce software documentation? by dustinrcollins on Friday June 14, 2013 @10:17AM (#5880028)
I think it's fine to document these things in Sphinx as well. Creating a docs repo and writing .rst files to cover these requirements can be useful, and then you can move them as needed as your project progresses.
Re:Ask HN: What do you use to produce software documentation? by swah on Friday June 14, 2013 @07:42AM (#5879336)
I'm using Latex for exactly that, but it sucks so much I considered building a product/business to solve the problem.
Re:Ask HN: What do you use to produce software documentation? by LukaszB on Friday June 14, 2013 @09:04AM (#5879640)
I guess you still have to use SC to be able to pickup changes by others right?
Re:Ask HN: What do you use to produce software documentation? by swah on Friday June 14, 2013 @11:28AM (#5880439)
Sorry, what is SC?
Re:Ask HN: What do you use to produce software documentation? by LukaszB on Monday June 17, 2013 @09:19AM (#5892953)
code Source Control...