Skip to content
Tagged articles

technical communication

23 articles · Page 1 of 1
Architecture Breakthrough
Architecture Breakthrough
Nov 10, 2026 · R&D Management

Golden Circle & 5W2H: A Universal Framework for Reviewing Presentation Decks

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
Golden Circle & 5W2H: A Universal Framework for Reviewing Presentation Decks
Architect's Guide
Architect's Guide
Oct 26, 2026 · R&D Management

Drawing Effective Architecture Diagrams with the C4 Model

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
Drawing Effective Architecture Diagrams with the C4 Model
Ubiquitous Tech
Ubiquitous Tech
Sep 29, 2026 · R&D Management

Why Business Struggles to Understand Tech Talks: Structured & Pyramid Thinking

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
Why Business Struggles to Understand Tech Talks: Structured & Pyramid Thinking
Architecture Breakthrough
Architecture Breakthrough
Sep 9, 2026 · R&D Management

Mainline Logic: The Backbone of Persuasive Architecture Planning Reports

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
Mainline Logic: The Backbone of Persuasive Architecture Planning Reports
Code Archaeology
Code Archaeology
Sep 7, 2026 · Fundamentals

Why C4 Starts with System Context Diagrams: A Step-by-Step Guide

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
Why C4 Starts with System Context Diagrams: A Step-by-Step Guide
Infinite Tech Management
Infinite Tech Management
Apr 24, 2026 · R&D Management

From Pig Pens to Skyscrapers: How Programmers Become Architects

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
From Pig Pens to Skyscrapers: How Programmers Become Architects
Chengwu Tech Stack
Chengwu Tech Stack
Jul 7, 2025 · R&D Management

Pyramid Thinking for Programmers: Lead with Conclusions to Align Product, QA, and Leadership

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
Pyramid Thinking for Programmers: Lead with Conclusions to Align Product, QA, and Leadership
Big Data Tech Team
Big Data Tech Team
May 7, 2025 · Fundamentals

Mastering Software Architecture Diagrams: A Practical C4 Methodology

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
Mastering Software Architecture Diagrams: A Practical C4 Methodology
Top Architecture Tech Stack
Top Architecture Tech Stack
Nov 18, 2023 · Fundamentals

How to Create Effective Software System Architecture Diagrams: 4+1 View, 4R Method, and Common Diagram Types

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
How to Create Effective Software System Architecture Diagrams: 4+1 View, 4R Method, and Common Diagram Types
Su San Talks Tech
Su San Talks Tech
Jan 7, 2023 · Fundamentals

Mastering Software Architecture Diagrams: From 4+1 to C4 Views

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
Mastering Software Architecture Diagrams: From 4+1 to C4 Views
Top Architect
Top Architect
Apr 1, 2022 · Fundamentals

Technical Writing Best Practices: Ten Essential Guidelines for Effective Documentation

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
Technical Writing Best Practices: Ten Essential Guidelines for Effective Documentation
IT Architects Alliance
IT Architects Alliance
Oct 20, 2021 · Fundamentals

How to Create Clear Architecture Diagrams: A Methodology Overview

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
How to Create Clear Architecture Diagrams: A Methodology Overview
Top Architect
Top Architect
Sep 28, 2021 · Fundamentals

How to Create Effective Software Architecture Diagrams: Concepts, Types, and Best Practices

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
How to Create Effective Software Architecture Diagrams: Concepts, Types, and Best Practices
IT Architects Alliance
IT Architects Alliance
May 17, 2021 · Industry Insights

How to Craft Clear Architecture Diagrams: A Practical C4 Methodology

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
How to Craft Clear Architecture Diagrams: A Practical C4 Methodology
Top Architect
Top Architect
Apr 18, 2021 · Fundamentals

How to Create Effective Software Architecture Diagrams: Concepts, Types, and Best Practices

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
How to Create Effective Software Architecture Diagrams: Concepts, Types, and Best Practices
Architecture Digest
Architecture Digest
Feb 20, 2021 · Fundamentals

How to Create Effective Software Architecture Diagrams: Concepts, Types, and Best Practices

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
How to Create Effective Software Architecture Diagrams: Concepts, Types, and Best Practices
Alibaba Cloud Developer
Alibaba Cloud Developer
Jan 13, 2021 · Backend Development

Mastering Technical Communication: From RPC Basics to Feynman Learning

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
Mastering Technical Communication: From RPC Basics to Feynman Learning
Code Ape Tech Column
Code Ape Tech Column
Jan 13, 2021 · Fundamentals

How to Craft Clear Architecture Diagrams with the C4 Model

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
How to Craft Clear Architecture Diagrams with the C4 Model
Programmer DD
Programmer DD
Mar 6, 2019 · Fundamentals

Clear Software Architecture Diagrams: A Practical Audience‑Focused Guide

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
Clear Software Architecture Diagrams: A Practical Audience‑Focused Guide
Qunar Tech Salon
Qunar Tech Salon
Aug 26, 2015 · Fundamentals

How to Effectively Ask Questions on Technical Forums and Mailing Lists

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
How to Effectively Ask Questions on Technical Forums and Mailing Lists