Lumina

Manuals / Bug Reporting & Advocacy / Ch 2

A · CraftBeginner35 min read

2. Repro steps that work

Bug Reporting & Advocacy · 36 pages source format

Numbered steps, starting state, test data, environment. If you can’t repro twice, say so — and what varies.

What you'll learn

  • Minimal repro
  • Starting state
  • Flake honesty

Minimal path

Strip irrelevant clicks. One path, one bug.

Environment: staging, Chrome 128, user role X, build abc123
Preconditions: account with … / flag ON
Steps:
1. …
2. …
Expected: …
Actual: …
Frequency: 3/3 (or 1/5 — flake)

Do this now

Rewrite your weakest bug’s steps. Time a teammate reproducing.

Pro tip. Video helps; it does not replace steps.

Clear?

Checklist