Python Docs for Humans. A Public Request to Kenneth Reitz

1 pointzoboomafoo2 comments

Kenneth,

This is missing.

We have __doc__ strings.

We could follow Google Python Docstring format style.

There's no simple way to generate a documentation.

Sphinx is a heavy pain for the beginner, and for the intermediate.

Pydoc seems the simplest to me, but its stylesheets left us in 1991.

Please, consider building Python Docs for Humans. :)

View on HN

I developed some much improved Python docs. User-editable, with comments and examples. Individual page for each function. Unfortunately the client I was working on it for seemed to lose all interest in launching it. They wanted it to be completely closed source and private, and to make a lot of money. I said Python folks would probably not respond well to that. It's been probably 2 years. It's in React, Redux and Node.

oh, right, it should be open source! :)

Reply on news.ycombinator.com