Pathwise

Manuals / Documentation Systems / Chapter 2

A · Structure · beginner · Week 1 · Chapter 2 of 9

Diátaxis: four doc types

Tutorials, how-to guides, reference, explanation. Mixing them confuses readers.

Path progress
22%

Step 1 of 1

Sort 10 pages

Sort 10 pagesDrag 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 →Sort 10 pagesdrag · tap →Try thisdrag · tap →Follow the dashed drag · tap →

Do this now

Label 10 existing docs by Diátaxis type. Note misfits to split.

Was this step clear?
Chapter learning outcomes
  • Four types
  • Sorting existing pages

Clear these before you leave