>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3534115. --> Reported by: [marcus_johansson](https://www.drupal.org/user/385947) Related to !1022 >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>Currently we use draw.io to show diagrams or charts on our documentation. The problem with this is that its not quite collaborative, since we have to store the draw file somewhere and its hard to follow changes or versioning of it.</p> <p><a href="https://mermaid.live/">https://mermaid.live/</a> can be used to preview and live edit a markdown to diagram and there is a plugin for mkdocs - the documentation system we are using: <a href="https://squidfunk.github.io/mkdocs-material/reference/diagrams/">https://squidfunk.github.io/mkdocs-material/reference/diagrams/</a></p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <ul> <li>Add the python/js dependencies according to documentation.</li> <li>Try it out on <a href="https://project.pages.drupalcode.org/ai/1.1.x/agents/orchestration/">https://project.pages.drupalcode.org/ai/1.1.x/agents/orchestration/</a></li> </ul>