[DonHopkins]

I have fallen in love with SVG+text Mermaid diagrams embedded in markdown code blocks, and LLMs are really great at generating them (by reading design documents and source code) and editing them with natural language commands. And they're not inaccessible unsearchable dead-end images you have to laboriously regenerate and check into the repo whenever you want to change something! ;)

Mermaid: Diagramming and charting tool: JavaScript based diagramming and charting tool that renders Markdown-inspired text definitions to create and modify diagrams dynamically.

https://mermaid.js.org/

Include diagrams in your Markdown files with Mermaid: A picture tells a thousand words. Now you can quickly create and edit diagrams in markdown using words with Mermaid support in your Markdown files.

https://github.blog/developer-skills/github/include-diagrams...

Creating diagrams: Create diagrams to convey information through charts and graphs:

https://docs.github.com/en/get-started/writing-on-github/wor...

The Official Guide to Mermaid.js:

https://github.com/PacktPublishing/The-Official-Guide-to-Mer...

[sandreas]

Mermaid looks amazing. Did not know gh had support just via

  ```mermaid

  ```

Thanks for mentioning this.