Raport de bug cu opinii în loc de fapte („coșul e un dezastru”)
Un raport scris cu nervi („coșul e un dezastru, calculul e varză”) nu spune ce s-a întâmplat și pune programatorul în defensivă. Scrie doar fapte verificabile: ce ai făcut, ce valoare a afișat aplicația și ce trebuia să afișeze conform cerinței.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Raportul de bug e un document de lucru, citit de programatori, de Product Owner și uneori de client. Cuvintele ca „dezastru”, „varză”, „nimeni n-a testat asta?” nu adaugă nicio informație: nu spun ce pagină, ce date, ce valoare greșită. În plus, transformă discuția despre problemă într-o discuție despre oameni.
Greșeala apare mai ales când testerul găsește același tip de bug a treia oară sau când bug-ul e grav și presiunea e mare. Rezultatul e previzibil: raportul se citește greu, se pierde timp cu întrebări („ce anume e greșit?”) și relația cu echipa de dezvoltare se strică.
Un raport bun sună neutru, aproape plictisitor: „Cu REDUCERE10 aplicat pe un coș de 249 lei, totalul afișat e 199,20 lei; conform R8 trebuia 224,10 lei.” Gravitatea o exprimi prin severitate, nu prin adjective.
De ce apare: cauzele frecvente
1Titlul exprimă o părere
Titlu: Coșul e un dezastru, reducerea e varzăTitlu: Coș: cu codul REDUCERE10 totalul scade reducerea de două oriTitlul corect spune unde, ce acțiune și ce efect. Părerea nu ajută pe nimeni să găsească bug-ul în lista de tichete.
2Rezultatul obținut e un reproș
Rezultat obținut: calculul e total aiurea, nimeni n-a testat asta?Rezultat obținut: Reducere −24,90 lei (corect), dar Total afișat 199,20 leiValorile afișate sunt faptele de care programatorul are nevoie. Întrebarea retorică nu conține nicio informație.
3Gravitatea exprimată prin majuscule și semne de exclamare
URGENT!!! TOTALUL E GREȘIT!!!Severitate: Critică · Prioritate: Foarte mareCâmpurile de severitate și prioritate există tocmai pentru asta și pot fi filtrate și sortate.
Corectează greșeala, direct în pagină
Raportul BUG-1 din tab-ul Bug-uri a fost scris la nervi: titlul și rezultatul obținut conțin doar păreri. Reprodu bug-ul în Aplicația (Căști Bluetooth în coș + codul REDUCERE10), apoi rescrie titlul și rezultatul obținut doar cu fapte: unde apare problema, ce valoare a afișat aplicația.
Indiciu
Titlul spune pagina, acțiunea și efectul; rezultatul obținut conține totalul afișat, în lei.
Reparația
Reprodu bug-ul, apoi rescrie raportul doar cu fapte.
1. În Aplicația: adaugă Căști Bluetooth în coș, deschide Coșul, aplică REDUCERE10. 2. Deschide BUG-1 și schimbă:
- Titlu: Coș: cu codul REDUCERE10 totalul scade reducerea de două ori
- Rezultat obținut: Rândul Reducere arată −24,90 lei (corect), dar Total afișat este 199,20 lei 3. Salvează.
De ce merge
Raportul rescris spune exact ce vede oricine reproduce bug-ul: rândul Reducere e corect, totalul nu. Programatorul știe imediat unde să caute (calculul totalului după reducere), fără să descifreze o părere.
Gravitatea rămâne exprimată prin severitatea Critică și prioritatea Foarte mare, care pot fi filtrate în lista de tichete. Tonul neutru păstrează discuția despre produs, nu despre oameni.
Alte forme ale mesajului
Unprofessional bug reportBug report toneRaport de bug scris agresiv
Cum o eviți pe viitor
- Recitește raportul înainte să-l salvezi și scoate orice adjectiv care nu e un fapt.
- Scrie valorile exacte afișate, nu cum ți se par.
- Folosește severitatea și prioritatea pentru gravitate, nu majusculele.
- Descrie comportamentul aplicației, nu oamenii care au scris-o.
- Dacă ești nervos, salvează raportul ca ciornă și revino peste cinci minute.
Întrebări frecvente
Nu e bine să arăt că bug-ul e grav?
Ba da, dar prin severitate, prioritate și impactul descris concret (de exemplu „clientul plătește mai puțin decât trebuie”). Impactul concret convinge mai mult decât orice adjectiv.
Pot scrie în raport că bug-ul a mai apărut?
Da, ca fapt util: „problema a apărut și în build 1.3.2, vezi BUG-12”. Asta ajută la analiza cauzei, fără reproșuri.
Greșeli înrudite
Titlu de bug vag („Nu merge căutarea”) Un titlu ca „Nu merge căutarea” nu spune unde, ce și în ce condiții, așa că bug-ul nu poate fi triat, căutat sau deosebit de altele. Scrie titlul după formula: unde + ce se întâmplă + condiția, de exemplu „Căutare: „laptop” cu litere mici nu găsește „Laptop UltraBook””. Raport de bug fără rezultat așteptat vs rezultat obținut Fără rezultat așteptat și rezultat obținut, raportul nu spune de ce e un bug: programatorul vede ce face aplicația, dar nu știe ce ar fi trebuit să facă. Scrie separat ce cere specificația (cu cifre) și ce afișează efectiv aplicația. Rezultat obținut fără valorile afișate („transportul e greșit”) „Transportul e greșit” spune că există o problemă, dar nu ce a afișat aplicația. Scrie în rezultatul obținut valorile exacte de pe ecran (subtotal, transport, total), ca programatorul să vadă diferența față de rezultatul așteptat fără să reproducă el bug-ul. Învață Testare manuală de la zero, cu exerciții la fiecare lecție
Curs Testare manuală (QA): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.
