Improving clarity demo

[maksimdrachov]

todo:

• [x] Add support for mermaid graphs
  • mgaitan/sphinxcontrib-mermaid

See also: maksimdrachov/opencyphal-tutorial

[maksimdrachov]

The last one is a useless change, but:

(Feel free to roll back)

[maksimdrachov]

This remaining issue in CI:

I've added sphinxcontrib.contentui in order to allow toggling the view of "Graph explanation" (see docs/pages/demo.rst). I think it's a bit clearer if the reader can toggle certain parts of the explanation that might be useful upon the first read, but migh otherwise be a bit too long to include in the default view of the page.

relevant issue in ulrobix/sphinxcontrib-contentui

Doesn't look like it's actively maintained anymore.

So I guess: remove this extension and replace by something similar. Any suggestions?

[pavel-kirienko]

@maksimdrachov nudge

[maksimdrachov]

Feel free to merge, or keep open (since I might want to change some other small stuff around as well)

[pavel-kirienko]

I might want to change some other small stuff around as well

That's fine, let's take these changes in as they come in separate PRs.