News for hackers. Stuff that matters.

A comment on Ask HN: Guidelines for making clear architecture diagrams. Parent comment

Re:Ask HN: Guidelines for making clear architecture diagrams by contingencies on Thursday May 02, 2024 @01:47AM (#40233074)
1. Yeah.

2. Strong disagree. IMHO icons in diagramming are obsolete for most purposes (smacking of UML and over-wrought database diagrams) and are likely to lead to confusion for the majority of viewers who - at best - aren't quite sure what you exactly mean in this particular case.

3. Which is what graphviz is for. It literally draws itself. Subgraphs are the groupings.

4. I would instead suggest modifying an existing graphviz .dot file, or man dot.

[ Parent | on HN ]
Re:Ask HN: Guidelines for making clear architecture diagrams by langnutty on Thursday May 02, 2024 @10:57AM (#40237058)
Re: 2 I would like a large icon and small text that confirms my intuition about what the icon means. The icon thereby eventually becomes part of my lexicon.

I don’t even see the text, I just see database, load balancer, Redis cache…

[ Parent | on HN ]