Tagged articles
technical communication
23 articles · Page 1 of 1
The article presents a three-step method for reviewing presentation materials: first, distance yourself for a day; second, apply the Golden Circle (Why, How, What) to validate structure, then use 5W2H from key stakeholder perspectives to refine content; finally, write and rehearse a script to uncover awkward phrasing.
5W2HGolden CircleR&D management
0 likes · 5 min read

This article introduces the C4 model as a practical methodology for creating clear, audience-focused architecture diagrams, covering context, container, component, and code levels with concrete examples from an Alibaba engineering team to solve common diagramming ambiguities.
AlibabaC4 modelarchitecture diagrams
0 likes · 12 min read

This article explains why technical professionals often confuse business stakeholders by dumping details without structure, and teaches structured thinking (organizing information into problem maps) and pyramid thinking (conclusion-first communication) with a practical formula (Conclusion + Evidence + Solution) and layered expression techniques for different audiences.
business communicationconclusion-firstdeliberate practice
0 likes · 18 min read

This article explains the C4 Container Diagram — its purpose, key attributes, notation, and a complete walkthrough using an Internet Banking System example to show how to decompose a system into applications, data stores, and their communication protocols.
AWS S3C4 modelSpring Boot
0 likes · 19 min read

This article explains how to create coherent architecture planning presentations by establishing a mainline logic driven by the report's purpose, using a classic general-specific-general structure, and defining each slide's role through three key questions to ensure logical flow and audience alignment.
PPT structureR&D managementarchitecture planning
0 likes · 6 min read

This article explains why the C4 model begins with system context diagrams, detailing their purpose, key elements (people, software systems, relationships), notation conventions, and a step-by-step example of creating a context diagram for an online banking system integrating with core banking and email services.
C4 modelarchitecture documentationonline banking example
0 likes · 14 min read

The article explains why coding skill alone isn’t enough, outlines the four essential architectural mindsets, shows how neglecting business, people, technology, and operational complexity turns systems into spaghetti, and offers concrete career advice for engineers at every level.
architectural thinkingcareer developmentcomplexity management
0 likes · 10 min read

This article explains how programmers can apply the Pyramid Principle — conclusion first, grouped arguments, logical progression — to structure technical proposals, documentation, PR descriptions, and cross-functional communication with product managers, QA, and leadership, providing concrete before-and-after examples and practice tips.
McKinseycode reviewcross-functional collaboration
0 likes · 13 min read

Learn seven practical storytelling and structuring frameworks—including Why‑What‑How, layered deep‑dive, F‑R‑S‑C‑O, Failure‑Driven Story, SCQA, and PREP—to turn a 30‑50 minute tech talk into an engaging narrative that resonates with both newcomers and senior engineers.
R&D managementknowledge sharingpresentation frameworks
0 likes · 15 min read

This article introduces a systematic approach to creating clear, audience‑focused software architecture diagrams using the C4 model, explains the purpose of different diagram types, outlines common pitfalls, and provides concrete examples and tool recommendations to improve communication among developers, ops, and stakeholders.
C4 modelDiagram Typesarchitecture best practices
0 likes · 12 min read

This article explains why good software architecture diagrams improve communication, introduces the classic 4+1 view and the practical 4R approach, and details drawing techniques and use‑cases for various diagram types such as business, frontend, system, application, deployment, and sequence diagrams.
4+1 view4R methodarchitecture diagrams
0 likes · 16 min read

Learn how to choose, design, and present clear software architecture diagrams—covering the classic 4+1 views and the modern C4 model—by understanding their definitions, audience needs, and visual conventions, enabling effective communication across stakeholders without ambiguity.
4+1 viewC4 modeldiagram-design
0 likes · 7 min read

This article presents ten essential guidelines for technical documentation, covering clear subject‑verb‑object sentences, proper use of pronouns and transition words, strong verbs, correct terminology, effective paragraph structure, concise openings, appropriate length, visual aids, lists and tables, consistent style, and overall document architecture.
Technical Writingdocumentationsoftware engineering
0 likes · 45 min read

This article explains the importance of architecture diagrams, defines key concepts, introduces the 4+1 and C4 modeling approaches, discusses common pitfalls, and provides practical guidance for producing self‑describing, audience‑focused diagrams that improve communication and alignment across product, operations, and development teams.
C4 modelarchitecture diagramssystem design
0 likes · 10 min read

This article explains the purpose of software architecture diagrams, defines key concepts, outlines common diagram types such as the 4+1 view and C4 model, discusses criteria for good diagrams, addresses typical pitfalls, and provides practical guidance and tool recommendations for producing clear, audience‑focused architecture visuals.
C4 modelarchitecture diagramssoftware architecture
0 likes · 10 min read

This article presents a practical methodology for creating clear software architecture diagrams, explaining core concepts, the 4+1 view classification, common pitfalls, and the C4 model with concrete examples, helping architects choose the right diagram type for their audience and purpose.
C4 modelarchitecturediagram
0 likes · 12 min read

This article explains the fundamentals of software architecture diagrams, introduces the 4+1 view taxonomy and the C4 model, describes how to choose the right diagram for different audiences, and shares practical tips, common pitfalls, and tool recommendations for clear, self‑describing architecture visuals.
C4 modelarchitecture diagramssoftware architecture
0 likes · 11 min read

This article explains the purpose and classification of software architecture diagrams, introduces the 4+1 and C4 modeling approaches, outlines criteria for good diagrams, addresses common pitfalls, and provides practical guidance and tool recommendations for producing clear, self‑describing architecture visuals.
C4 modelarchitecture diagramssystem design
0 likes · 12 min read

This article explores common pitfalls in technical communication, offers practical questioning techniques, and demonstrates how to simplify complex concepts such as RPC and service registries using the Feynman method, enabling engineers to convey ideas clearly and improve collaboration efficiency.
Feynman TechniqueRPCbackend development
0 likes · 11 min read

This article explains the fundamentals of software architecture diagrams, outlines the purpose and classification of different diagram types, describes common pitfalls, and provides a step‑by‑step guide to using the C4 model—including system context, container, component, and class diagrams—plus a real‑world case study.
Best PracticesC4 modelarchitecture
0 likes · 11 min read

This article explains the purpose and value of architecture diagrams, defines key concepts, outlines five common view types, discusses criteria for good diagrams, highlights common pitfalls, and introduces the C4 modeling approach with examples to help engineers communicate system designs effectively.
C4architecturediagram
0 likes · 9 min read

This article explains why clear architecture diagrams are essential for communication, outlines common pitfalls, introduces the 4+1 view and C4 modeling approaches, and provides practical advice on creating audience‑centric, self‑describing diagrams that align with code and improve development efficiency.
C4 modelarchitecture diagramssoftware architecture
0 likes · 11 min read

This guide explains how to choose the right forum or mailing list, write clear and concise subject lines, provide detailed yet focused problem descriptions, use proper formatting, and follow etiquette so that your technical questions receive helpful responses from the community.
forum etiquettemailing listquestion asking
0 likes · 31 min read
