#+TITLE: Roads for Success Navigating Docs source:roads for success navigating docs | kyle gill | developer & designer author:20200430190114-kyle_gill[kyle gill]]

• tags :: writing, gatsby, documentation, guidance

• 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.=