Multiple Files for Sequence Diagrams

[amessbee]

ATM, for each sequence diagram (e.g. one at the bottom of https://docs.agoric.com/guides/orchestration/) in documentation, we are keeping two files

• .svg diagram graphic to be displayed on docs pages
• .mmd mermaid source file to generate sequence diagram from

This is a potential duplication of information that requires more than required amount effort to maintain.

[dckc]

This increases dependence on client-side JavaScript. Before this change, the source (from curl) includes:

... cross-chain transactions.</p><br><img src="/assets/orchestration-workflow-1.CN3JBV8-.svg" width="100%"><br></div>

but with this change, we get:

... cross-chain transactions.</p><div class="mermaid"></div>

It's not clear why JavaScript should be required for static images.

[dckc]

The indirect dependencies brought in by vitepress-plugin-mermaid include d3, katex, vscode-languageserver, and so on. I wonder if all that is worthwhile.

[amessbee]

This increases dependence on client-side JavaScript. Before this change, the source (from curl) includes:

... cross-chain transactions.</p><br><img src="/assets/orchestration-workflow-1.CN3JBV8-.svg" width="100%"><br></div>

but with this change, we get:

... cross-chain transactions.</p><div class="mermaid"></div>

It's not clear why JavaScript should be required for static images.

I don't know enough javascript to be sure, but I believe <div class="mermaid"> is just a static stylesheet class to be (optionally) defined by us, and does not affect the rendering of svg if you remove or change it (in a not-so-adversarial way I suppose).

[dckc]

It's not clear why JavaScript should be required for static images.

I don't know enough javascript to be sure, but I believe <div class="mermaid"> is just a static stylesheet class to be (optionally) defined by us, and does not affect the rendering of svg if you remove or change it (in a not-so-adversarial way I suppose).

<div class="mermaid"> affects the rendering of the svg image in that (without JavaScript) it provides no rendering whatsoever. Not even a link where you could download the image. Note the lack of an <img> element.