News for hackers. Stuff that matters.
Re:Ask HN: How do people generate documentation from Python ... by jjgreen on Tuesday January 25, 2022 @10:14AM (#30072664)
It used to be that Sphinx [1] was the go-to solution, possibly something else has emerged since I was doing this sort of thing. Some example output at [2]

[1] https://www.sphinx-doc.org/en/master/

[2] http://soliton.vm.bytemark.co.uk/pub/docs/mvpoly/

Re:Ask HN: How do people generate documentation from Python ... by StokoeKeagan on Tuesday January 25, 2022 @11:04AM (#30073375)
I'm in the process of setting up docs for a Python based CLI and Sphinx has continually come up as the best option. Ran through the setup today and it was straightforward, next step is figuring out how to auto-generate the docs from docstrings.
Re:Ask HN: How do people generate documentation from Python ... by jjgreen on Tuesday January 25, 2022 @12:34PM (#30074861)
This is the source for those docs, but Makefiles and autoconf which tends to make people cross nowerdays ...

https://gitlab.com/jjg/mvpoly/-/tree/master/src/python