It seems there's a new Open Source documentation generator project out there pretty regularly and I'm sure a litany of paid services to manage better docs. In the past we've used lots of different tools from jsdoc parsers to stoplight; however we're in the need for a new solution that can work well for a very small team.<p>Primarily looking for:<p>- API Docs
- SDK Docs
- Code structure docs (beyond tests and codecoverage)
Sphinx is very nice to work with, and it's been around for a long time. I've used it for Python projects, C++ projects (with doxygen and breathe), and some programming language agnostic things. It's almost trivial to pair Sphinx docs with readthedocs.org as well. For smaller pieces of documentation (and many personal things) I use Org mode in Emacs. Org mode supports exporting to a wide variety of formats.
After sweating drops of blood through my forehead and recording the results with Libre Office, I then export it to PDF.<p>I've tried super-duper generators in the past. They never seem to give you results that are worth the effort and time spent.