Controlled Vocabulary
summary
A controlled vocabulary is a living organized list that emerges from an audit of 600 pages of existing docs plus interviews with customers and visits to marketing, product, support, and engineering. The process produces concrete rules: one meaning per term, pair verbs with nouns, and maintain a living reference. Results include fewer internal misunderstandings, shorter, more consistent docs, and measurable influence on product language and roadmap alignment.
AI-written summary · about
chapters (7)
- 0:00Introduction
- 0:15The Docs
- 0:46What is a Controlled Vocabulary
- 2:09Standup
- 2:23Assumptions
- 3:13Reviewing Documentation
- 3:55Tips
related talks
31mWhatchamacallit: Controlled Vocabularies for Technical Writers
41mOne glossary to rule them all: terminology management at scale
16mcod == doc
40mCode is your partner in thought
16mFree Your Mind, and Your Docs Will Follow
44mHumanizing Your Documentation
36mTo document, or not document that is the question
28mContemporary Documentation