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/
I have a slight preference towards mkdocs.
Without much configuration I think it tends to look better.