Sphinx is overkill: just turn a folder of Python docstrings into static HTML

From the thread · top comments

pdoc is the lightest path when you only need HTML from Python docstrings. If you also keep Markdown guides, or you might add OpenAPI later, another option is Sourcey ( https://sourcey.com/ ). Sourcey builds a static HTML docs site from OpenAPI, MCP, Doxygen, godoc, rustdoc, and Markdown. Setup is small: init scaffolds a config, dev gives a local preview, and build emits static files you can host anywhere. For Python modules you can lean on Doxygen-style docblocks and keep narrative pages in Markdown beside the reference. I use the project pages at https://sourcey.com/oss when I want the genera

Well, Python has its own documentation system, which I have never used, but I am sure that @SteveBarnes can help :-) I think that you want a tool called Sphinx Personally, I use Doxygen for documenting C and C++ an it looks like you can use it for Python too - https://www.doxygen.nl/manual/docblocks.html#pythonblocks Doxygen has been around forever and is a powerful tool. Take a look at the website. Also take a look at https://www.sphinx-doc.org/en/master/index.html and see which you prefer

pdoc is worth considering. pip install pdoc then call pdoc --html mymodule --output-dir docs to generate the HTML documentation.