De reținut
- Un raport de bug descrie o problemă atât de clar încât altcineva o poate reproduce, îi poate înțelege impactul și o poate repara.
- Esența e simplă: pașii de reproducere, rezultatul așteptat, rezultatul obținut, plus mediul și dovezile.
- Rapoartele excelente sunt precise, minimale și neutre. Un bug pe raport, fapte, nu vinovați.
Ce este un raport de bug
Un raport de bug (numit și raport de defect sau issue) înregistrează o problemă pe care ai găsit-o. De obicei se scrie într-o unealtă de urmărire precum Jira, Azure DevOps, GitHub Issues sau Bugzilla.
Are trei cititori:
- Programatorul, care trebuie să o reproducă și să găsească cauza.
- Product ownerul sau liderul, care decide cât de urgent se repară.
- Tu, mai târziu, când trebuie să o retestezi după reparare.
Un bug care nu poate fi reprodus, de obicei, nu poate fi reparat. De aceea raportul e la fel de important ca descoperirea.
Ce conține un raport de bug
| Câmp | Ce scrii |
|---|---|
| Titlu | Ce e greșit, unde și în ce condiție. Scurt și precis. |
| Mediu | Versiunea sau build-ul aplicației, browserul sau dispozitivul, sistemul de operare, mediul de test, rolul utilizatorului. |
| Precondiții | Ce e nevoie înainte de pași: tip de cont, date, setări. |
| Pași de reproducere | Numerotați, minimi, exacți. Include datele folosite. |
| Rezultat așteptat | Ce ar trebui să se întâmple, ideal cu link spre cerință. |
| Rezultat obținut | Ce s-a întâmplat de fapt. Mesajele de eroare exacte, copiate, nu reformulate. |
| Frecvență | De fiecare dată sau în 3 din 10 încercări? |
| Severitate | Cât de grav e impactul. Prioritatea e stabilită adesea mai târziu, de product owner. |
| Atașamente | Captură de ecran, video, log-uri, cereri de rețea (fișier HAR), erori din consolă. |
Un raport slab și unul excelent
Slab:
Titlu: Checkout-ul e stricat!!!
Checkout-ul nu merge. Vă rog reparați urgent.
Programatorul trebuie să ghicească totul: ce pagină, ce utilizator, ce metodă de plată, ce înseamnă „nu merge”.
Excelent:
Titlu: Checkout: butonul „Plătește” nu face nimic când e aplicat un cod de reducere (Safari 17)
Mediu: Build 2.14.0, staging, Safari 17.4 pe macOS 14. Client autentificat.
Pași:
- Adaugă orice produs în coș.
- Aplică codul de reducere
PRIMAVARA10.- Mergi la checkout și apasă Plătește.
Așteptat: Se deschide formularul de plată.
Obținut: Nu se întâmplă nimic. Consola afișează
TypeError: discount.total is undefined.Frecvență: 5 din 5 încercări. Merge în Chrome 124. Merge în Safari fără cod de reducere.
Atașamente: înregistrare video a ecranului, captură a consolei.
Lecția: al doilea raport restrânge deja problema la Safari plus cod de reducere, înainte ca un programator să-l deschidă. Asta înseamnă să izolezi un bug și economisește ore întregi.
Obiceiuri care duc la reparații
- Reprodu-l întâi. Mai încearcă o dată înainte să raportezi. Notează dacă apare de fiecare dată.
- Izolează-l. Schimbă câte un singur lucru: alt browser, alt utilizator, alte date. Fiecare diferență găsită restrânge cauza.
- Caută duplicate. Poate l-a raportat deja cineva. Adaugă detaliile tale acolo.
- Un bug pe raport. Două probleme într-un raport înseamnă că una e uitată când cealaltă se repară.
- Pași minimi. Scoate orice pas care nu e necesar ca să apară bug-ul.
- Copiază, nu reformula. Textul exact al erorii, valorile exacte, URL-urile exacte.
- Rămâi neutru. Descrie comportamentul produsului, nu persoana care l-a construit.
Așa da
Să scrii titluri ca pe o căutare: „Factura PDF: TVA-ul apare 0 la comenzile cu livrare gratuită.” Oricine îl găsește mai târziu.
Așa nu
Să scrii titluri ca „Bug la facturi”, „Nu merge” sau „URGENT!!!”. Ascund problema și dau un ton greșit.
După ce l-ai raportat
Un raport de bug are un ciclu de viață. Stări des întâlnite: Nou → Asignat → Reparat → De retestat → Închis, plus Redeschis dacă reparația nu funcționează.
Când vine reparația, rulează din nou pașii inițiali ca să confirmi că problema a dispărut. Apoi verifică zona din jur, în caz că reparația a stricat altceva.
Verifică-te
Ai descoperit că pagina de căutare nu afișează niciun rezultat pentru cuvântul „ciocolată”, dar merge pentru „ciocolata”. Care ar fi un titlu bun pentru raport?
Arată răspunsul
Ceva de genul: „Căutare: niciun rezultat pentru termeni cu diacritice (ex. «ciocolată»); «ciocolata» funcționează.” Spune unde e bug-ul, ce îl declanșează și dă un exemplu, așa că oricine înțelege problema doar din titlu.
