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.