Hacker News with Generative AI: Technical Communication

Common mistakes in architecture diagrams (2020) (ilograph.com)
When creating a technical architecture diagram, your goal is to give understanding to your audience. You want to honestly inform viewers about your system rather than merely make an impression. Mistakes made when creating diagrams can undermine this goal, however. Here are seven common mistakes to avoid when making technical architecture diagrams.
Architecture Diagrams, Technical Communication, Software Development, Design Mistakes
200 points by billyp-rva 12 days ago | 72 comments
Society for Technical Communication to permanently close its doors (stc.org)
Despite significant efforts over the past several years by the various Boards of Directors and STC leadership, financial liabilities coupled with falling membership numbers have created a situation where we are not able to offer the education, resources, and outreach that this membership expects and deserves.
Society, Technical Communication, Membership Organizations, Financial Difficulties
87 points by Sgt_Apone 23 days ago | 25 comments
Common Mistakes in Architecture Diagrams (2020) (ilograph.com)
When creating a technical architecture diagram, your goal is to give understanding to your audience. You want to honestly inform viewers about your system rather than merely make an impression. Mistakes made when creating diagrams can undermine this goal, however. Here are seven common mistakes to avoid when making technical architecture diagrams.
Architecture, Design, Software, Technical Communication
4 points by billyp-rva 29 days ago | 0 comments
Blog Writing for Developers (2023) (rmoff.net)
Writing is one of the most powerful forms of communication, and it’s useful in a multitude of roles and contexts. As a blog-writing, documentation-authoring, twitter-shitposting DevEx engineer I spend a lot of my time writing. Recently, someone paid me a very nice compliment about a blog I’d written and asked how they could learn to write like me and what resources I’d recommend.
Software Development, Writing, Content Creation, Blog Writing, Technical Communication
255 points by mooreds 109 days ago | 43 comments