Debugnotities omzetten in een reproduceerbaar bugrapport
Een goed bugrapport laat iemand anders het probleem begrijpen en proberen het te reproduceren. Door notities te ordenen scheid je bewijs van theorieën die tijdens het debuggen ontstonden.
Begin met het juiste materiaal.
- Wat je aanlevert
- reproductienotities van de gebruiker en bevindingen op de huidige pagina.
- Het beoogde resultaat
- Sla een gestructureerd issue op met feitelijk bewijs en nog ontbrekende reproductiedetails.
Hoe de workflow werkt.
Leg de omgeving, reproductiestappen, verwacht gedrag, werkelijk gedrag en aangeleverde logs of verwijzingen vast. Markeer onzekere waarnemingen en behoud de exacte fouttekst waar die van belang is.
Wat je in het resultaat controleert.
Controleer of iemand anders genoeg informatie heeft om het scenario te proberen. Ontbrekende versies of stappen moeten open vragen blijven, en een ongeteste hypothese mag niet als hoofdoorzaak worden bestempeld.
Bekijk de Markdown-voorvertoning om naast de tekst ook koppen, lijsten en links te controleren. Bewaar bronverwijzingen bij het document, zodat een beoordelaar belangrijke uitspraken kan herleiden tot je aangeleverde materiaal.
Leer van het uitgewerkte voorbeeld.
Het downloadbare Markdown-voorbeeld laat één mogelijke indeling van het resultaat zien. Lees het naast het bronvoorbeeld en herken vastgelegde feiten, voorgestelde tekst en vragen die nog een antwoord nodig hebben.
Het aangeleverde voorbeeld is ter illustratie. Het is geen vastgelegde uitvoering met jouw gegevens.
Download het voorbeeld ↓Gebruik het met je eigen materiaal.
- Open de bron waarmee je wilt werken en activeer WebAct op dat tabblad.
- Kopieer de taak uit het bovenste blok, voeg vereiste velden of voorkeuren toe en controleer de voorgestelde acties.
- Vergelijk het eerste resultaat met je bron. Vraag waar nodig om een gerichte correctie of verfijning.