69 ms·

On topic, anyone know of a repository or collection of nice architecture diagrams out there?

ramon156 2y ago
Not a repo but I remember a book titled something like "architecture in 500 lines or less" that had really pretty explanations and diagrams
- sesm 2y ago
  Was it this one: https://github.com/aosabook/500lines https://github.com/aosabook/500lines ?
belter 2y ago
https://aws.amazon.com/architecture/reference-architecture-diagrams/?solutions-all.sort-by=item.additionalFields.sortDate&solutions-all.sort-order=desc&whitepapers-main.sort-by=item.additionalFields.sortDate&whitepapers-main.sort-order=desc&awsf.whitepapers-tech-category=*all&awsf.whitepapers-industries=*all https://aws.amazon.com/architecture/reference-architecture-d...
mdaniel 2y ago
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
- billyp-rva 2y ago
  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-diagrams-distributed-load-testing/ https://www.ilograph.com/blog/posts/better-aws-architecure-d...
thusjustin 2y ago
This is, of course, extremely subjective, but I find myself using this slide deck from Google Cloud (https://docs.google.com/presentation/d/1fD1AwQo4E9Un6012zyPEb7NvUAGlzF6L-vo5DbUe4NQ/edit#slide=id.p173 https://docs.google.com/presentation/d/1fD1AwQo4E9Un6012zyPE...) as inspiration and/or to see how others design their diagrams.

Not a repo but I remember a book titled something like "architecture in 500 lines or less" that had really pretty explanations and diagrams

sesm 2y ago
Was it this one: https://github.com/aosabook/500lines https://github.com/aosabook/500lines ?

belter 2y ago

https://aws.amazon.com/architecture/reference-architecture-diagrams/?solutions-all.sort-by=item.additionalFields.sortDate&solutions-all.sort-order=desc&whitepapers-main.sort-by=item.additionalFields.sortDate&whitepapers-main.sort-order=desc&awsf.whitepapers-tech-category=*all&awsf.whitepapers-industries=*all https://aws.amazon.com/architecture/reference-architecture-d...

mdaniel 2y ago

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

billyp-rva 2y ago
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-diagrams-distributed-load-testing/ https://www.ilograph.com/blog/posts/better-aws-architecure-d...

thusjustin 2y ago

This is, of course, extremely subjective, but I find myself using this slide deck from Google Cloud (https://docs.google.com/presentation/d/1fD1AwQo4E9Un6012zyPEb7NvUAGlzF6L-vo5DbUe4NQ/edit#slide=id.p173 https://docs.google.com/presentation/d/1fD1AwQo4E9Un6012zyPE...) as inspiration and/or to see how others design their diagrams.