Titlu de bug prea lung (tot raportul scris în titlu)
Un titlu care povestește tot ce ai făcut („Am adăugat în coș..., am mers..., am apăsat...”) nu se mai poate citi în lista de bug-uri. Titlul spune scurt unde și ce nu merge, sub 90 de caractere, iar pașii și cifrele merg în câmpurile lor.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Titlul (rezumatul) unui bug se vede în liste, în filtre, în notificări și în ședințele de triere, de obicei tăiat după primele cuvinte. Dacă tot raportul e înghesuit acolo, nimeni nu înțelege din prima ce s-a stricat, iar câmpurile de dedesubt (pași, rezultat așteptat, rezultat obținut) rămân goale.
Un titlu bun răspunde la două întrebări: unde (pagina sau componenta) și ce nu merge, de exemplu „Coș: cu codul REDUCERE10 totalul scade reducerea de două ori”. Restul, adică produsele folosite, ordinea acțiunilor și sumele exacte, are loc în pași și în rezultate.
Greșeala apare des la început, când tester-ul scrie raportul ca pe un mesaj de chat. Separarea pe câmpuri face raportul ușor de citit, de căutat și de comparat cu alte rapoarte (de exemplu ca să găsești duplicatele).
De ce apare: cauzele frecvente
1Toți pașii puși în titlu
Titlu: Am adăugat Căști Bluetooth în coș, am deschis coșul, am scris REDUCERE10, am apăsat Aplică și totalul e 199,20 lei în loc de 224,10 lei
Pași: (gol)Titlu: Coș: cu codul REDUCERE10 totalul scade reducerea de două ori
Pași:
1. Adaugă în coș „Căști Bluetooth” (249 lei)
2. Deschide Coșul
3. Scrie codul REDUCERE10 și apasă AplicăÎn listă se vede doar începutul titlului lung („Am adăugat Căști Bluetooth...”), care nu spune nimic despre problemă. Varianta scurtă se înțelege din prima.
2Cifrele și explicațiile în titlu
Titlu: Totalul e 199,20 lei dar ar trebui 224,10 lei pentru că reducerea e 10% și se scade o dată conform R8Titlu: Coș: cu REDUCERE10 reducerea se scade de două ori din total
Rezultat așteptat: Total 224,10 lei (R8)
Rezultat obținut: Total 199,20 leiSumele exacte și referința la cerință sunt utile, dar în câmpurile Rezultat așteptat și Rezultat obținut, unde programatorul le caută.
Corectează greșeala, direct în pagină
Raportul BUG-1 din tab-ul Bug-uri are tot conținutul înghesuit în titlu, iar pașii lipsesc. Scurtează titlul la cel mult 90 de caractere (unde + ce nu merge, cu codul de reducere) și mută acțiunile în cel puțin 3 pași de reproducere.
Indiciu
Titlul poate începe cu „Coș:” și trebuie să spună ce se întâmplă cu totalul după codul de reducere.
Reparația
Scurtează titlul și mută acțiunile în pași.
1. Deschide BUG-1 și schimbă titlul în: Coș: cu codul REDUCERE10 totalul scade reducerea de două ori 2. Completează pașii: 1. Adaugă în coș „Căști Bluetooth” (249 lei) → 2. Deschide Coșul → 3. Scrie codul REDUCERE10 și apasă Aplică → 4. Citește rândurile Reducere și Total. Salvează.
De ce merge
Titlul nou are sub 70 de caractere și spune exact unde (Coș) și ce (reducerea se scade de două ori din total). În lista de bug-uri și în ședința de triere toată lumea înțelege problema fără să deschidă raportul.
Acțiunile au ajuns în pași, unde programatorul le urmează una câte una, iar sumele au rămas în rezultatul așteptat și cel obținut. Fiecare informație stă în câmpul ei, deci raportul e mai ușor de citit și de căutat.
Alte forme ale mesajului
Bug summary too longBug title best practicesRezumatul bug-ului prea lung
Cum o eviți pe viitor
- Formula simplă: Pagina/componenta + ce nu merge (+ în ce condiție).
- Ține titlul sub 80–90 de caractere; dacă e mai lung, mută detaliile în pași.
- Nu pune în titlu „am făcut”, „am apăsat”: acelea sunt pași.
- Pune cifrele exacte în Rezultat așteptat și Rezultat obținut.
- Citește titlul singur, fără restul raportului: înțelegi ce s-a stricat?
Întrebări frecvente
Cât de lung trebuie să fie titlul unui bug?
Nu există o regulă oficială, dar majoritatea echipelor țin titlul pe un rând, de obicei sub 80–100 de caractere. Important e să se înțeleagă unde și ce nu merge fără să deschizi raportul.
Pun în titlu și rezultatul așteptat?
Doar dacă rămâne scurt și ajută („transportul nu e gratuit la 200 lei”). Dacă devine o frază lungă, păstrează în titlu problema și mută valorile în câmpurile de rezultat.
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””. Bug raportat fără pași de reproducere Un raport de bug fără pași de reproducere spune ce s-a stricat, dar nu cum ajungi acolo, așa că programatorul nu poate reproduce problema și bug-ul se întoarce la tine. Scrie pașii numerotați, câte o acțiune pe pas, cu datele exacte folosite. 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. Î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.
