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 Sphinx style is not that modern compared to mkdocs, but there are plenty of themes - anyway those can not change the generated markup. If it comes to api-docs, Sphinx is more comprehensive while mkdocs takes more space. So it's more a matter of taste?
If it comes to authoring I love the power of Sphinx. Paired with MyST parser and using Markdown in Sphinx it is my tool of choice.