Sphinx was originally created for the Python documentation. It is the most recommended and well documented documentation generator. A tool that actually makes programmers want to write documentation!
Ranked in these QuestionsQuestion Ranking
Pro Good documentation and lots of examples listed on their website
Sphinx documentation is well written and very detailed. From beginner to advanced user can easily navigate through their navigation.
Pro Output comes with different format
It supports reStructuredText in docstrings and produces an HTML output with a clean visual style. Automatic links for functions, classes, citations and glossary terms. It has a hierarchical structure and automatic indices.
Con Too complex for a beginner
It requires a bit of configuration. It introduces using Makefile. It can also be run using a quickstart script but also requires a bit of steps to begin.