{
  "video_id": "reddit_1u30h1w",
  "channel_slug": "programming",
  "channel_handle": "r/programming",
  "title": "7 More Common Mistakes in Architecture Diagrams",
  "url": "https://www.reddit.com/r/programming/comments/1u30h1w/7_more_common_mistakes_in_architecture_diagrams/",
  "external_url": "https://www.ilograph.com/blog/posts/more-common-diagram-mistakes/",
  "upload_date": "20260611",
  "published_at": "2026-06-11T14:21:57+00:00",
  "transcript": "\n\n--- Top Comments ---\n\n\n[87 upvotes] Master diagrams happen because some process will ask for one to tick off a tickbox somewhere. Weird thing to call a mistake.\n\n[55 upvotes] Mistake #0 - making an architecture diagram.\n\nSource: 15+ years of making architecture diagrams.  Been off the juice for nearly 15 years.\n\n[35 upvotes] I disagree with a lot of these. I think the problem might be, that the post completely disregards that diagrams might have different audiences and there is a difference if that audience is the tech lead of another team or the IT department of your customer who's vetting your system.\n\n>Mistake #1: Not including resource names\n\nSo for example when I send a diagram to a customer, I do not include internal names. These are of absolutely no concern to a user of our system. They want to know what we are roughly doing? Fine. But I don't go into details.\n\n>\\#6 Fan traps\n\nSame here. If my point is to convey that we have a message broker and redundant systems on both ends, that fan representation is exactly the right detail level. The audience of that information doesn't care about topics.\n\n>\\#2 Unconnected resources\n\nSomeone asks for an overview that fits on one page or one slide? Then of course I will have multiple things in there. I may even use that to *highlight* that certain parts are unconnected (but still exist).\n\n>\\#4 Conveyor belt syndrome\n\nSure, a sequence diagram was made to solve this. But this assumes we are doing UML. So again, depending on the audience, the conveyor belt migh",
  "transcript_chars": 1529,
  "ingested_at": "2026-06-12T01:30:19.514960+00:00",
  "source": "reddit",
  "yt_meta": {
    "score": 168,
    "upvote_ratio": 0.86,
    "num_comments": 33,
    "author": "fagnerbrack",
    "is_self": false
  }
}