Worksheet · Bug Report Builder

Grad ⏱ ~20 min ✏ Writing exercise

Read the bug scenario below, then fill in every field of the bug report template. The Guru will send your report back if it is missing Steps to Reproduce or a clear Expected Result — just like a real developer would.

Learning: Write It Down · Defect Reporting (Junior)

🐛 The Bug You Found

You are testing KiwiCart, a small NZ online grocery ordering app. You are working through the checkout flow as part of your grad practice session.

What you observed:

You added 3 items to your cart and proceeded to checkout. On the delivery address screen, you entered a valid NZ address including a suburb and postcode. When you clicked "Continue to payment", the page showed a spinner for about 4 seconds and then displayed a blank white page. The URL changed to /checkout/payment but no content loaded. The browser console (F12) showed a JavaScript error: TypeError: Cannot read properties of undefined (reading 'suburb').

You refreshed the page and were taken back to an empty cart — your 3 items were gone.

Your task: Write a complete, professional bug report so a developer can reproduce and fix this issue. Every field marked * is mandatory.

💡 Why every field matters

✏ Bug Report Template

Fill in all fields. Fields marked * are required before the Guru will review your report.

One clear sentence: what broke, where, and what happened. Not "Bug in checkout" — be specific.

Please write a descriptive title.

How badly does this affect users? Critical = data loss or app unusable. Low = cosmetic issue.

Please select a severity level.

Browser, OS, device, and app version. e.g. "Chrome 124, Windows 11, KiwiCart v2.1.0"
What state must the app be in before you start? Account logged in? Items already in cart?
Numbered steps. Be specific enough that a developer who has never seen the bug can follow them and see it themselves.

Steps to Reproduce is required. A report without reproduction steps cannot be fixed.

What actually happened? Be specific — include error messages, UI state, console errors.

Please describe what actually happened.

What should have happened? Describe the correct behaviour, not just "it should work".

Expected Result is required. Without it, the developer cannot confirm whether their fix is correct.

Reproducibility (always/sometimes/once), workarounds, related issues, screenshots you would attach.
⚠️
Report sent back for revision

📝 Revision needed. The Guru has sent your report back. Read the feedback in the chat panel on the right, fix the flagged fields, then resubmit.

💡 What the Guru will check

The Guru will send your report back if Steps to Reproduce or Expected Result are missing, too vague, or only one sentence. This mirrors how a real development team handles incomplete bug reports.

✅ Sample Answer

TitleBlank page displayed after entering valid delivery address at checkout — cart items lost on refresh
SeverityCritical — data loss (cart cleared) and complete payment flow failure
EnvironmentChrome 124, Windows 11, KiwiCart v2.1.0 (staging environment)
Preconditions1. User is logged in to KiwiCart.
2. Cart contains at least 1 item (any item).
Steps to Reproduce 1. Navigate to https://kiwicart.co.nz and log in with a registered account.
2. Add any 3 items to the cart.
3. Click the cart icon and select "Proceed to checkout".
4. On the delivery address screen, enter a valid NZ address:
   Name: Test User
   Street: 14 Aroha Street
   Suburb: Petone
   City: Lower Hutt
   Postcode: 5012
5. Click "Continue to payment".
Actual ResultA loading spinner appeared for approximately 4 seconds. The page then became a blank white screen. The browser URL changed to /checkout/payment but no page content loaded. The browser console (F12 → Console) displayed the error: TypeError: Cannot read properties of undefined (reading 'suburb'). Refreshing the page at /checkout/payment redirected to an empty cart — the 3 items were lost.
Expected ResultAfter clicking "Continue to payment", the payment screen should load within 2 seconds, displaying: the order summary (items, quantities, subtotal), the entered delivery address for confirmation, and payment method options (credit/debit card, PayNow). No errors should appear and the cart should be preserved.
Additional NotesReproduced consistently: 3 out of 3 attempts. Tried with different NZ postcodes (Auckland 1010, Christchurch 8011) — same result. Would attach screenshot of blank page and console error. Possible cause: the suburb field is not being mapped correctly when passed to the payment page component.

Key things the sample gets right: The title names the symptom AND the side effect (cart loss). Steps include exact test data. Actual result quotes the console error verbatim. Expected result specifies the layout, timing, and what should be preserved — a developer can use this directly to write a fix acceptance criterion.

Progress saved