Another new-ish gem in the Sphinx ecosystem, sphinxcontrib-mermaid makes it easy to drop Mermaid diagrams-as-code into docs, even Python docstrings.