Ask HN: What do you use to produce software documentation?
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?
1 comments
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.
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.