Bug reporting & QA guides

Bug reports developers can act on: templates, steps to reproduce, when to attach a recording, and a clean handoff from QA to engineering.

• How to write a bug report developers can act on Bug reporting & QA · 11 min read

  How to write a bug report a developer can fix without a single follow-up question: title, environment, steps, expected vs actual, evidence and severity.

• Bug report templates for web apps, mobile, visual and performance bugs Bug reporting & QA · 11 min read

  Copy-paste bug report templates for web apps, mobile web, visual, performance, intermittent and error bugs, plus a GitHub issue form and a chat version.

• How to write steps to reproduce that anyone can follow Bug reporting & QA · 11 min read

  Write steps to reproduce that work for a stranger: a clean starting state, one action per step, a minimal repro, environment details and intermittent bugs.

• The QA to developer handoff checklist, from triage to closing the loop Bug reporting & QA · 11 min read

  A QA to developer handoff checklist: when a bug is ready for a developer, triage, evidence, test data, verifying the fix on the right build, closing the loop.

• Video bug reports: how to record a bug developers can fix Bug reporting & QA · 12 min read

  When to attach a screen recording to a bug report, what to show in the first ten seconds, how to mark the failure, and how to keep secrets out of the frame.