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

6 pointsLukaszB7 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?

View on HN

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.

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

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.

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

I guess you still have to use SC to be able to pickup changes by others right?

Sorry, what is SC?

code Source Control...

Reply on news.ycombinator.com