| Docs section | Must answer | Smell |
|---|---|---|
| Overview | What problem does this solve? | Starts with props before purpose. |
| Usage | When should and shouldn’t I use it? | Only screenshots, no decision rules. |
| Content | What should the words say? | Lorem ipsum or vague labels. |
| Accessibility | What behavior is required? | No keyboard, focus, label, or role guidance. |
| Implementation | How do I use and migrate safely? | Code exists, but no constraints or migration notes. |
Fast adoption checks
- Can a new team choose the right variant without asking you?
- Do docs include anti-examples and misuse?
- Do examples use realistic product copy?
- Are accessibility expectations explicit?
- Is there migration guidance when old usage changes?