Sphinx support of mermaid (documentation images)
Gabriel suggested that we consider mermaid to make it easier to add diagrams in our documentation: https://www.thelinuxfaq.com/npm/npm-packages/mermaid
For an example of what it can do, see the image in this issue description: #406
I think it would make things a lot easier for maintainers and code authors, so long as there is a low installation burden. The images need to render both in PDF and html. This issue is for any discussion about whether or not to start using it, and documentation of recommended installation steps for our supported Linux and macOS versions.