Looking for tool to use for a documentation website

[edvardfagerholmsc]

I'm trying to improve some documentation and would like to find the right tool for the job. Currently the docs are in Confluence, which I hate for many reasons. I've written some other documentation using Jekyll, but noticed this option too.

I have certain requirements:

1. I need to be able to render the Jupyter book into a website.
2. Need to support math (LaTeX)
3. Writing sequence diagrams and state machines should be really easy (otherwise docs will turn obsolete fast)

My understanding is that (2) works somewhat out-of-the-box. LaTeX has pgf-umlsd, which looks reasonably simple for making sequence diagrams that other can copy paste and edit. How hard is configuring (3)? I couldn't immediately find any documentation.

Any tutorials that would cover all the steps? Some jekyll plugins also support local searching of the generated page. Would anything similar exist for Jupyter Books?

[rgaiacs]

Many people are using https://mermaid.js.org/ for diagrams. There are a Sphinx extension to support mermaid.js https://pypi.org/project/sphinxcontrib-mermaid/.

[edvardfagerholmsc]

I'm using mermaid with Jekyll, so if that also works with Jupyter Books, then all the better.