Ever finished a neat Python script only to see it later lay unused by anyone else because the only documenting effort you gave it was the petty README.md? Ever found Sphinx too cumbersome to use for the small project on your hands or have repeatedly found reST syntax for links too volatile to touch-type, whereas you had always loved and adored markdown? Many have. Documentation is a PITA to maintain. Real programmers don't document their programs — documentation is for simpletons who can't read object code from memory dumps. Right?
Documentation is like sex: when it is good, it is very, very good;— Dick B.
and when it is bad, it is better than nothing.
Enter pdoc, the perfect documentation generator for small-to-medium-sized, tidy Python projects. It generates documentation simply from your project's already-existing public modules' and objects' docstrings, like sphinx-apidoc or sphinx.ext.autodoc, but without the hassle of these tools. Minimal and lightweight. Guaranteed 99% correct magic out of the box!