News for hackers. Stuff that matters.

A comment on Beyond Whiteboarding: Creating Expert System Architecture Diagrams.

Re:Beyond Whiteboarding: Creating Expert System Architecture... by tmountain on Wednesday November 03, 2021 @08:50AM (#29093855)
These fail my litmus test, which is, "can a third-party look at the diagram and make sense of it without verbal explanation?" For a more formal approach to coherent diagrams and white boarding, I recommend the C4 model. It's conceptually simple and results in better system documentation than the free form method that's commonly used.

https://youtu.be/x2-rSnhpw0g

[ Parent | on HN ]
Re:Beyond Whiteboarding: Creating Expert System Architecture... by sitkack on Wednesday November 03, 2021 @10:02AM (#29094680)
Learning the language of understanding charts and diagrams is not obvious. From reading maps to understanding log-log plots, box and violin plots, etc. I mean there is a whole industry around this.

I think the ability to be able to transition in the same diagram to different semantic complexity levels is amazing. I want this for ALL of my communication and information mediums.

I am only commenting on the tools ability to zoom in and out from an abstraction level and not on the philosophy of how diagrams are constructed.

[ Parent | on HN ]
Re:Beyond Whiteboarding: Creating Expert System Architecture... by radicalbyte on Wednesday November 03, 2021 @09:51AM (#29094522)
The C4 model is better than the spaghetti most people make whilst trying to fit everything and the kitchen sink into a single model.
[ Parent | on HN ]