Pathwise

Manuals / Documentation Systems / Chapter 8

C · System · advanced · ~25 min · Chapter 8 of 9

Discoverability

Index pages, naming conventions, tags, “start here.” If people can’t find it, it doesn’t exist.

Path progress
89%

Step 1 of 1

Start-here page

Start-here pageDrag stickies · tap for tips
Study mapDrag stickies · tap for tipsKeep it shortdrag · tap →Name the waitdrag · tap →Scope locatorsdrag · tap →Trace when stuckdrag · tap →One browser firstdrag · tap →Isolate statedrag · tap →Assert the UIdrag · tap →Retry wiselydrag · tap →Seed datadrag · tap →Close the loopdrag · tap →Keep it shortdrag · tap →Name the waitdrag · tap →Scope locatorsdrag · tap →Trace when stuckdrag · tap →One browser firstdrag · tap →Isolate statedrag · tap →Pathwise hackdrag · tap →Start-here pagedrag · tap →Try thisdrag · tap →Follow the dashed drag · tap →

Do this now

Create a start-here index for your team’s top 10 tasks.

Was this step clear?
Chapter learning outcomes
  • Index design
  • Naming
  • Slack → doc redirection

Clear these before you leave