Meta issue for tracking documentation improvements. - [x] limitation with footnotes, references (see https://github.com/mkdocstrings/pytkdocs/issues/26) - [ ] how to document enumeration values - [x] recommendation: giving a heading to each object, even modules - [x] suggest https://github.com/analog-garage/mkdocstrings-python-xref as alternate handler with relative cross-refs - [x] suggest https://github.com/jcayers20/mkdocs-autoapi for automatic generation of pages (see https://github.com/mkdocstrings/mkdocstrings/issues/389) - [ ] [see all issues with docs label](https://github.com/issues?q=is%3Aissue+user%3Apawamoy+user%3Amkdocstrings+archived%3Afalse+sort%3Areactions-%2B1-desc+label%3Adocs) - [x] Make it more prominent that show_submodules is needed for recursivley documenting submodules (see https://github.com/mkdocstrings/python/issues/146)
Meta issue for tracking documentation improvements.