Pathwise

Manuals / Bug Reporting & Advocacy / Chapter 5

A · Craft · beginner · ~25 min · Chapter 5 of 9

Titles & taxonomy

Searchable titles: component + failure. Labels for area. Don’t bury the lede in “weird issue.”

Path progress
56%

Step 1 of 1

Title clinic

Bad: “Button broken.” Better: “Checkout — Pay CTA disabled after applying expired coupon.”

Title clinicDrag 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 →Title clinicdrag · tap →Try thisdrag · tap →Follow the dashed drag · tap →

Do this now

Rewrite 5 titles for clarity + search.

Was this step clear?
Chapter learning outcomes
  • Title patterns
  • Duplicates
  • Components

Clear these before you leave