Aw Snap! The Docs, They Are A-Changin’
summary
Examines concrete claims and evidence: a survey of 150 responses (55% with >16 years experience) and the surprising datum that 10% reported anything goes for style. Reviews changes in guidance — Microsoft Manual of Style added chapters on global content, bias‑free language, emojis and SEO — and shows real microcopy examples (humor, contractions, emojis, pop culture) with localization and comprehension concerns. Watch for methods, quoted percentages, live examples, and whether the documented innovations actually help users.
AI-written summary · about
chapters (22)
- 0:00Introduction
- 0:48Bob Dylan
- 3:32Whats Changing
- 4:44Food Analogies
- 5:22Different Rules
- 6:37Microsoft Manual of Style
- 8:35The Language Survey
- 9:56Todays Examples
- 12:15User Guide
- 13:16Humor
- 14:49Slang
- 18:16contractions
- 18:57conversational style
- 19:42microcopy
- 20:04error message
- 21:13emojis
- 21:32idioms and expressions
- 21:55examples
- 23:19pop culture references
- 24:15killer robots
- 26:04Tulsa time
- 28:11Takeaways
related talks
23mWhat They Don't Tell You About Creating New Style Guides
26mBefore the Docs: Writing for User Interfaces
16mFree Your Mind, and Your Docs Will Follow
34mHumanizing Your Documentation
29mHumanizing Your Documentation
29mDocumentation: The Missing Pieces
29mHumanizing Your Documentation
28mHumanizing Your Documentation