Przejdź do treści
TestLine Menu
TestLine
proces QA

Jak zgłaszać defekty, żeby programista nie miał pytań

Co wpisać w zgłoszenie, żeby dało się je odtworzyć i naprawić bez dopytywania.

autor
Artur Machowski, Senior QA Engineer
opublikowano
czytanie
6 min

Ile kosztuje złe zgłoszenie

Zgłoszenie o treści “koszyk nie działa” zaczyna serię pytań: gdzie, na jakim koncie, w której wersji. Programista traci czas, tester wraca do tematu po kilku dniach, a błąd czeka. W testach manualnych i automatycznych zgłosiłem ponad 450 defektów i najwięcej czasu oszczędzały nie wyszukane narzędzia, tylko porządnie opisane zgłoszenia.

Dobre zgłoszenie spełnia jeden warunek: osoba, która nie widziała błędu, potrafi go odtworzyć.

Tytuł, który coś mówi

Tytuł powinien opisywać objaw i miejsce. Zespół czyta go na liście, często bez otwierania zgłoszenia.

  • Słabo: Błąd w koszyku
  • Dobrze: Koszyk: kod rabatowy znika po zmianie liczby produktów

Co musi się znaleźć w zgłoszeniu

Tytuł: Koszyk: kod rabatowy znika po zmianie liczby produktów
Środowisko: staging, wersja 2.14.0, Chrome 130, Windows 11
Konto: użytkownik testowy z rolą klienta
Kroki:
  1. Dodaj produkt do koszyka.
  2. Wpisz kod rabatowy i zatwierdź.
  3. Zmień liczbę sztuk z 1 na 2.
Wynik oczekiwany: rabat pozostaje naliczony.
Wynik faktyczny: rabat znika, cena wraca do pełnej.
Powtarzalność: 5 na 5 prób.
Załączniki: nagranie, log z konsoli.

Pamiętaj o trzech rzeczach:

  • Kroki od początku. Nie zakładaj, że czytelnik wie, skąd zacząłeś.
  • Oczekiwany i faktyczny wynik osobno. Bez tego nie wiadomo, czy to błąd, czy nieporozumienie co do wymagań.
  • Powtarzalność. “Czasem” też jest wartościową informacją, jeśli napiszesz, jak często.

Dowody

Nagranie albo zrzut ekranu skraca rozmowę, a log często wskazuje przyczynę. W aplikacjach mobilnych przyda się Logcat na Androidzie, a na backendzie log serwisu z tego samego momentu. Do błędów API dołącz żądanie i odpowiedź.

Usuń z załączników prawdziwe dane osobowe, hasła i tokeny. System zgłoszeń widzi zwykle więcej osób niż produkcja.

Priorytet a ważność

To dwie różne rzeczy, które łatwo pomylić.

  • Ważność (severity) mówi, jak poważny jest skutek techniczny.
  • Priorytet mówi, jak szybko trzeba to naprawić z punktu widzenia biznesu.

Literówka w nazwie firmy na stronie głównej ma niską ważność i wysoki priorytet. Awaria rzadko używanego raportu może być odwrotnie. Tester proponuje ważność, a priorytet warto ustalać wspólnie, np. na triage.

Jeden defekt, jedno zgłoszenie

Dwa problemy w jednym zgłoszeniu oznaczają, że jeden zostanie naprawiony, a drugi zapomniany. Przed zgłoszeniem sprawdź też, czy ktoś nie opisał już tego samego. Jeśli tak, dopisz nowe informacje do istniejącego zgłoszenia.

Zamknięcie pętli

Praca nie kończy się na zgłoszeniu. Po naprawie sprawdź poprawkę na tym samym scenariuszu i obok niego, bo zmiana w jednym miejscu lubi psuć sąsiednie. Jeśli ten sam typ błędu wraca, warto dopisać go do regresji.

Podsumowanie

Dobre zgłoszenie to konkretny tytuł, powtarzalne kroki, dwa wyniki i dowód. Taki szablon zespół wdroży w jeden dzień, a zysk widać przy każdym kolejnym błędzie. Jeśli chcesz uporządkować proces zgłaszania i triage, napisz do mnie.

Seria “Testowanie od podstaw”

Ten poradnik jest też czwartą częścią serii dla osób, które zaczynają w testowaniu:

  1. Czym zajmuje się tester i jak zacząć
  2. Teoria testowania w pigułce
  3. Jak napisać przypadek testowy
  4. Jak zgłaszać defekty (ten wpis)
  5. Testowanie API od podstaw
  6. Pierwsze kroki w automatyzacji testów

Masz release za kilka tygodni?

Opisz projekt w formularzu. Odpiszę z pytaniami o zakres albo z wstępnym planem testów.