For code references in docs, do you prefer Sphinx or Mkdocs?
- Sphinx with autodoc. Example: https://xocto.readthedocs.io/en/latest/xocto/numbers.html
- Mkdocs with mkdocstrings. Example https://fastapi.tiangolo.com/reference/parameters/
For code references in docs, do you prefer Sphinx or Mkdocs?
- Sphinx with autodoc. Example: https://xocto.readthedocs.io/en/latest/xocto/numbers.html
- Mkdocs with mkdocstrings. Example https://fastapi.tiangolo.com/reference/parameters/
@danielfeldroy I use Sphinx and reStructuredText for the one library package that I've built and have hosted by Read The Docs (see: https://docs.wwdt.me).
I've eyed mkdocs for other projects or a future version of that library package if/when I do a major rewrite.