Ask HN: What do you use to produce software documentation?

6 points by LukaszB 12 years ago | 7 comments

We use github + markdown + wiki. Is there anything which offer collaboration on document (documentation to be specific) which allows all team members to edit/comment/iterate the docs?

dochtman 12 years ago |

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.

LukaszB 12 years ago | |

How about the situation when the documentation has to be prepared before any of implementation or coding starts (initial requirements, qc etc.) ?

dustinrcollins 12 years ago | | |

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.

swah 12 years ago | | |

I'm using Latex for exactly that, but it sucks so much I considered building a product/business to solve the problem.