Explaining Hard Things to Humans – The Principles of Effective Tech Communication
summary
Explains concrete rules for technical communication: avoid arrogance (don’t gatekeep expertise) and avoid breeziness (don’t skip tacit prerequisites); be audience-aware by listing the exact background learners need and using analogies (WordPress as a factory) to translate concepts; be strategic by tying explanations to the listener’s goal (what a client needs to decide); practical tips include rewriting confusing UX text and simple empathy hacks (smile when speaking, remove sarcastic phrasing).
AI-written summary · about
chapters (17)
- 0:00Introduction and speaker
- 0:21What is technical communication
- 1:25Why technical communication matters
- 2:28The hill analogy explained
- 3:29Gaps in knowledge and context
- 4:12Attitude problems in tech communication
- 5:14Arrogance vs breeziness explained
- 6:36How to communicate effectively
- 6:57Audience-aware communication
- 7:18Using analogies for clarity
- 8:19Listing required knowledge
- 9:02Strategic communication explained
- 9:42Tailoring communication to goals
- 10:26Avoiding non-strategic language
- 11:07Summary of key principles
- 11:50Empathy in technical communication
- 12:33Closing and call to action
