4 ms·
Ask HN: Writing software documentation
What tool do you use to write/maintain software documentation?
The product I'm documenting is fairly complex in that it has a server component and client libraries for a ton of languages, so I (will) have a tons of API docs, tutorials, admin guides, overviews, etc.
The default solution seems to by Sphinx, and I used it on the previous product, but it's not enough. It's too level, ie. I don't want to create tables, I want the tool to create tables based on templates. Also, Sphinx generates good readable pages, but it's not good for API docs IMO. (I think the Python API docs are not very good.)
I find the best consistent documentation out there is MSDN. Ideally I'd like something that takes some markup and generates documentation like that.