Skip to content

documentation

Auto-generating package API with mkdocstrings

Whenever I land on a new Python package docs these days, the docs tend to be built with mkdocs and the mkdocs-material theme, heralding a bit of a departure from the era of the Sphinx.

It's true, Sphinx still remains very popular and is endlessly extensible through its directives feature and its many plugins, but there is something about the beauty of mkdocs-material, its ease of deployment and its richness in features that makes it such a popular choice right now.