Hacker News new | ask | show | jobs
by perrygeo 86 days ago
Most common mistake: Creating diagrams in a graphics program without semantics. Why not write your "diagram" in code or at least some structured format?

- LLMs can read and write it, it serves as valuable context

- Always up to date, rendered on demand

- source controllable

- editable (thus will actually get edited)

Most architectural diagrams I see are just images with no source or semantics. Strictly less useful and more prone to rot.