News for hackers. Stuff that matters.
Re:Common Mistakes in Architecture Diagrams (2020) by potamic on Monday February 10, 2025 @01:24AM (#42997482)
On topic, anyone know of a repository or collection of nice architecture diagrams out there?
Re:Common Mistakes in Architecture Diagrams (2020) by ramon156 on Monday February 10, 2025 @04:26AM (#42998467)
Not a repo but I remember a book titled something like "architecture in 500 lines or less" that had really pretty explanations and diagrams
Re:Common Mistakes in Architecture Diagrams (2020) by sesm on Monday February 10, 2025 @07:20AM (#42999439)
Re:Common Mistakes in Architecture Diagrams (2020) by belter on Monday February 10, 2025 @09:05AM (#43000434)
Re:Common Mistakes in Architecture Diagrams (2020) by mdaniel on Monday February 10, 2025 @10:49AM (#43001631)
There's a small asterisk to your question: there's no way to verify that the diagrams represent the underlying system without access to the code (and sometimes the deployment). Anyone can make pretty pictures without spaghetti lines, but it takes some real, no kidding, discipline to write code (and then deploy that code) in a non-spaghetti way

It's like that phrase "no plan survives first contact with the enemy" but applied to product owners and then subsequently applied to computers

Re:Common Mistakes in Architecture Diagrams (2020) by billyp-rva on Monday February 10, 2025 @10:56AM (#43001703)
100% correct. The only ones which had both a repo and a diagram that I've consistently found were AWS sample architectures. Their diagrams are usually pretty lacking, though: https://www.ilograph.com/blog/posts/better-aws-architecure-d...
Re:Common Mistakes in Architecture Diagrams (2020) by thusjustin on Monday February 10, 2025 @11:22AM (#43002015)
This is, of course, extremely subjective, but I find myself using this slide deck from Google Cloud (https://docs.google.com/presentation/d/1fD1AwQo4E9Un6012zyPE...) as inspiration and/or to see how others design their diagrams.