For documentation, I often prefer Sphinx over static site builders like Hugo and Jekyll, as I can
- have one source for html, epub, and PDFs,
- create docs from Jupyter Notebooks with Jupyterbook,
- write in markdown with MyST, and
- use book-like features such as index, glossary, bibliography, footnotes, and figure captions.
A disadvantage of Sphinx is that smaller documentations often look a bit empty with the most common themes for html. Another is that multilingual content is not as nice to author, but that is a topic for another post.
Today, I stumbled across the Furo Sphinx theme. I like it’s minimal appearance and that it looks good even with small documentations. I think I’ll give it a try.