el-easydraw VS C4-PlantUML

https://github.com/misohena/el-easydraw is like 4/5 of the way there, check it out

https://github.com/misohena/el-easydraw is a cool proof of concept, but on installing it was practically unusable for me. Probably some setting on the preview size made the canvas too small, and the mouse did not line up with the icons to add things to the canvas. Still, amazing this is even possible!

I had not thought of this. I found this editor as well which looks promising. I’ll try it out.

And with org-noter one can easily interface with org-mode, and then maybe some more.

https://github.com/misohena/el-easydraw (some impressive ideas here)

Third this. Don't look any further, just do it!

Also, PlantUML + C4 is like peanut butter & jelly:

https://github.com/plantuml-stdlib/C4-PlantUML

I'll gladly give up control of layout, and accept some ugliness, to never again have to worry about dragging boxes and arrows to be pixel-aligned, and then do it all over again when I add another box...

It looks like Mermaid has C4 support too:

https://mermaid.js.org/syntax/c4.html

C4-PlantUML: Export your model as C4-PlantUML diagrams.

PlantUML + C4 plugin;

Yes. I use this all the time for software diagramming. With c4 model (https://github.com/plantuml-stdlib/C4-PlantUML) and AWS icons (https://github.com/awslabs/aws-icons-for-plantuml)

The C4 model (https://c4model.com/) is great for architecture diagrams. You can use different tools to generate them. Here are the ones I've been using:

- https://github.com/plantuml-stdlib/C4-PlantUML

3️⃣ Text-based diagramming- C4-PlantUML

> onboarding docs

yes, they're don't changing frequently

> system design docs

yes - see C4-PlantUML[1]

> meeting notes

no, unless they're directly code related like ADRs [2,3].

Although one can abuse Github Issues + comments for this, in my opinion it's better to use modern SaaS tools for this, i.e. Loom, Descript, Linear.app, etc. - you can automate this process, e.g. transcribe the meeting's recording and add the issue/repo using Github Actions.

--

[1] https://github.com/plantuml-stdlib/C4-PlantUML

[2] https://adr.github.io/

[3] https://docs.aws.amazon.com/prescriptive-guidance/latest/arc...