Coming from recent endeavors aiming to modernize different Sphinx documentation repositories we are maintaining, let me start by reporting about different advancements in the area of the Sphinx documentation generator and its ecosystem, which materialized in the recent years.
First of all, I would like to outline the excellent Furo theme, which advertises itself as a clean customisable Sphinx documentation theme.
Also, very massive advancements are coming from The Executable Books Project, around Chris Sewell, Chris Holdgraf, and contributors, with connections to The Jupyter Project, see Background and history and their team.
This is also a very capable theme, using Bootstrap.
is a Sphinx extension for designing beautiful, screen-size responsive web-components. It brings in grid-, card-, dropdown-, tab-, badge-, and button-elements, supporting both reStructuredText and MyST.
The installation documentation page of Streamlink looks so sweet!
– Via: Installation - Streamlink 5.5.1 documentation – which also uses the Furo theme, by the way.
For a long time, the power of the Sphinx documentation generator was only available to people writing documentation in reStructuredText. Because Markdown gained significant popularity in recent years, the community was in a big dilemma, and I am sure there have been endless Programming Language Wars-style discussions around using reStructuredText vs. Markdown for documentation authoring.
Effectively, it brings Markdown to Sphinx in full swing – finally.