Roads for Success Navigating Docs
source: roads for success navigating docs | kyle gill author: people.kyle_gill
- Key metaphor: Docs are like roads
- Need to be repaired, maintained and developed
- Some need different speed
- There are likely multiple pathways to the same destination
Tutorials are like highways
- Happy path
- Get you to the destination quickly
- Minimal friction
- Less possibilities
Guides are like city streets and backroads
-
More connections
-
Smaller chucks of relevant info
-
Mightn't move as fast or be as direct but get you to an exact point
=Learning is more like a graph with nodes and edges than a ladder with steps=
=Fewer, well-maintained docs can be much more valuable than many poorly maintained ones.=