software testing documentation guide
W mojej karierze testera oprogramowania nigdy nie słyszałem, aby ludzie mówili dużo o dokumentacji testowania oprogramowania. Ogólna opinia na temat dokumentacji testowej jest taka, że każdy, kto ma wolny czas, może wykonać dokumentację, taką jak przypadek testowy, plan testów, raport o stanie, raport o błędzie, propozycję projektu itp.
Nawet ja nie podkreślałem bardziej dokumentacji, ale mogę powiedzieć, że mam w zwyczaju umieszczanie wszystkich danych w czerni i bieli i aktualizowanie innych na ten temat.
Czego się nauczysz:
- Moje doświadczenie
- Dokumentacja testowa: co to jest?
- 10 wskazówek, które pomogą Ci osiągnąć cel dokumentacji testowej
- Ważne dokumenty dotyczące testowania oprogramowania
- Wniosek
- rekomendowane lektury
Moje doświadczenie
Chcę tylko podzielić się z Tobą moim doświadczeniem:
Dostarczyliśmy projekt (z nieznanym problemem) jednemu z naszych klientów (zły klient). I znaleźli problem po stronie klienta, co było dla nas bardzo złą sytuacją i jak zwykle cała wina spoczywała na kontroli jakości.
jaki jest twój klucz bezpieczeństwa sieci
Problem dotyczył zgodności jednej strony internetowej. Kiedy dotarło do mnie, miałem dowód, że nie dostałem takiego dokumentu wymagań, z którego wynika, że muszę również sprawdzić kompatybilność strony internetowej. Dzięki Bogu byłem bezpieczny.
To była dla mnie lekcja, zdałem sobie sprawę, jak ważna jest dokumentacja i od tego dnia zacząłem pracować nad dokumentami i tworzyłem dokumenty testowe, takie jak Plan testów, Przypadki testowe, lista kontrolna testów poprawności, raporty o błędach i wiele innych.
„Atrament jest lepszy niż najlepsza pamięć” - chińskie przysłowie
Dokumentacja testowa: co to jest?
Wszyscy czytamy różne artykuły na temat technologii i metod testowania, ale ilu z nas widziało artykuły dotyczące dokumentacji? Niewątpliwie jest ich niewielu, czy to, że dokumenty nie są ważne? Nie, ale to dlatego, że nie zdaliśmy sobie jeszcze sprawy z wagi dokumentów.
Ale jeśli zaobserwujemy, faktem jest, projekty, które mają wszystkie dokumenty, mają wysoki poziom dojrzałości.
Większość firm nie przywiązuje nawet małej wagi do dokumentacji, tak jak przykłada się do procesu tworzenia oprogramowania. Jeśli szukamy w sieci, możemy znaleźć różne szablony, jak tworzyć różne typy dokumentów. Ale ile z nich jest naprawdę używanych przez organizacje lub osoby prywatne?
Fakt jest taki staranna dokumentacja może zaoszczędzić czas, wysiłek i pieniądze organizacji.
Idąc do dowolnego typu certyfikacji, kładzie się nacisk na dokumentację, tylko dlatego, że pokazuje ona znaczenie klienta i procesów dla jednostki i organizacji. O ile nie jesteś w stanie stworzyć dokumentu wygodnego dla użytkownika, bez względu na to, jak dobry jest Twój produkt, nikt go nie zaakceptuje.
Z mojego doświadczenia wynika, że posiadamy jeden produkt, który ma nieco zagmatwaną funkcjonalność.
Kiedy zacząłem nad tym pracować, poprosiłem o kilka dokumentów pomocy do Managera i otrzymałem odpowiedź „Nie, nie mamy żadnych dokumentów”. Następnie zgłosiłem ten problem, ponieważ jako osoba odpowiedzialna za kontrolę jakości wiedziałem, że nikt nie może zrozumieć, jak używać produktu bez dokumentów i szkolenia. A jeśli użytkownik nie jest zadowolony, jak zamierzamy zarabiać na tym produkcie?
„Brak dokumentacji staje się problemem akceptacji” - Wietse Venema
Nawet to samo dotyczy instrukcji obsługi. Weźmy na przykład Microsoft, oni uruchamiają każdy produkt z odpowiednimi dokumentami, nawet dla Office 2007 mamy takie dokumenty, które są bardzo objaśniające i łatwe do zrozumienia dla każdego użytkownika. To jeden z powodów, dla których wszystkie ich produkty są skuteczne.
W małych firmach zawsze słyszeliśmy „odrzucenia projektów w fazie propozycji lub w fazie początkowej”. Dzieje się tak tylko dlatego, że w dokumentacji propozycji brakuje zwięzłego i wyrazistego języka, i aby pokazać możliwości organizacji.
Nie chodzi o to, że małe firmy nie mogą realizować projektów dobrej jakości, ale o ich niezdolność do wyrażenia swoich możliwości. (Ja też pracuję z małą organizacją 80 pracowników i słyszałem to wielokrotnie)
Osobiście uważam, że jedynym działem, który może to umożliwić, jest jakość. Jesteśmy jedynym departamentem, który może się w tej kwestii spierać i zapewnić pomyślną przyszłość naszym organizacjom.
Zorganizujmy całą dyskusję w kilku punktach z perspektywy jakości:
- Wyjaśnij cel i metody dotyczące jakości
- Zapewnij jasność co do zadań i spójność wykonania
- Zapewnij wewnętrzną koordynację w pracy klienta
- Przekazywanie informacji zwrotnych na temat działań zapobiegawczych
- Przekaż opinię dotyczącą cyklu planowania
- Stwórz obiektywne dowody skuteczności swojego systemu zarządzania jakością
10 wskazówek, które pomogą Ci osiągnąć cel dokumentacji testowej
Jak wspomniałem we wcześniejszym poście, ogólnie rozumienie dokumentacji testowania oprogramowania brzmi: „Może to zrobić tylko osoba, która ma wolny czas”. Musimy zmienić ten sposób myślenia i tylko wtedy możemy wykorzystać moc dokumentacji w naszych projektach.
Nie chodzi o to, że nie wiemy, jak prawidłowo wykonać dokumentację. Po prostu uważamy, że to nie jest ważne.
Każdy musi mieć standardowe szablony dla wszelkiego rodzaju dokumentacji, począwszy od strategii testów, planu testów, przypadków testowych i danych testowych po raport o błędzie.
Mają one po prostu być zgodne z niektórymi standardami (CMMI, ISO itp.), Ale jeśli chodzi o rzeczywistą implementację, ile z tych dokumentów jest przez nas naprawdę używanych? Musimy tylko zsynchronizować nasz proces jakości ze standardami dokumentacji i innym procesem w organizacji.
Najprostsza rzecz do przestrzegania wszelkiego rodzaju dokumentacji polega na zaangażowaniu w projekt osoby z fazy początkowej, która rozumie dynamikę projektu, jego dziedzinę, cel i technologię. A kto inny lepiej niż osoba odpowiedzialna za kontrolę jakości (oczywiście są obecni pisarze techniczni, którzy to robią - ale biorąc pod uwagę ogólny scenariusz małych firm, w których nie ma pisarzy technicznych).
jak sprawdzić utratę pakietów w sieci
Aby osiągnąć ten cel, jakim jest testowanie i dokumentowanie, musimy skupić się na kilku punktach.
Oto 10 najważniejszych wskazówek, które pomogą Ci osiągnąć cel dokumentacji testowej:
# 1) Zapewnienie jakości powinno odbywać się w pierwszej fazie projektu, tak aby kontrola jakości i dokumentacja współpracowały ze sobą.
#dwa) Proces zdefiniowany przez QA powinien być wykonywany przez osoby techniczne, co pomaga usunąć większość usterek na bardzo początkowym etapie.
# 3) Tylko tworzenie i utrzymywanie Szablony testowania oprogramowania to za mało, zmuszaj ludzi do ich używania.
# 4) Nie tylko twórz i opuszczaj dokument, aktualizuj w razie potrzeby.
# 5) Wymóg zmiany jest ważnym etapem projektu, nie zapomnij dodać ich do listy.
# 6) Używaj kontroli wersji do wszystkiego. Pomoże to w łatwym zarządzaniu i śledzeniu dokumentów.
# 7) Uprość proces usuwania defektów poprzez dokumentowanie wszystkich defektów. Upewnij się, że zawarłeś jasny opis wady, odtworzysz kroki, dotknięty obszar i szczegóły dotyczące autora podczas dokumentowania każdej wady.
# 8) Spróbuj udokumentować, co jest wymagane, abyś zrozumiał swoją pracę i co będziesz musiał przedstawić swoim interesariuszom, gdy zajdzie taka potrzeba.
# 9) Użyj standardowego szablonu do dokumentacji. Jak każdy szablon arkusza Excela lub szablon pliku doc i trzymaj się go dla wszystkich potrzeb związanych z dokumentami.
# 10) Udostępniaj wszystkie dokumenty związane z projektem w jednym miejscu, dostępnym dla każdego członka zespołu w celach informacyjnych, a także aktualizuj w razie potrzeby.
Nie mówię, że stosując kroki uzyskasz nagłe rezultaty. Wiem, że ta zmiana nie nastąpi za dzień lub dwa, ale przynajmniej możemy zacząć, aby te zmiany zaczęły zachodzić powoli.
Przecież „dokumentacja wymaga dokumentacji”. Prawda?
Istnieją setki dokumentów wykorzystywanych podczas tworzenia i testowania oprogramowania.
Ważne dokumenty dotyczące testowania oprogramowania
Tutaj wymieniam kilka ważnych dokumentów dotyczących testowania oprogramowania, których musimy regularnie używać / utrzymywać:
1) Plan testów
2) Projekt testów i Specyfikacja przypadku testowego
3) Strategia testów
4) Raporty podsumowujące testy
5) Tygodniowy raport o stanie
6) Dokumenty / podręczniki użytkownika
7) Raport akceptacji użytkownika
8) Ocena ryzyka
9) Dziennik testów
10) Zgłaszanie błędów
jedenaście) Dane testowe
12) Analiza testów
Ponadto testerzy oprogramowania muszą regularnie odwoływać się do następujących dokumentów:
1) Specyfikacje wymagań oprogramowania
2) Dokumenty funkcjonalne
Wniosek
Dokumenty testowania oprogramowania zawsze odgrywają ważną rolę w fazie rozwoju projektu / testowania. Dlatego zawsze przechowuj rzeczy udokumentowane, jeśli to możliwe. Nie polegaj na komunikacji werbalnej. Bądź zawsze po bezpiecznej stronie.
Dokumentacja nie tylko pozwoli Ci zaoszczędzić, ale także pomoże organizacji na dłuższą metę zaoszczędzić tysiące dolarów na szkoleniach i, co ważniejsze, na naprawie problemów spowodowanych brakiem dokumentów programistycznych i testowych.
Nie dokumentuj tylko po to, by nie wskazywać na siebie palcem, ale nawyk dokumentowania z pewnością zapewni systematyczne podejście do procesu testowania, pozostawiając za sobą testy ad hoc.
O autorze: Ten artykuł został napisany przez członka zespołu STH Tejaswini. Pracuje jako QA manager w organizacji.
Jakie inne dokumenty utrzymujesz podczas codziennych czynności testowych?
rekomendowane lektury
- Jak napisać tygodniowy raport o stanie testów oprogramowania
- Najlepsze narzędzia do testowania oprogramowania 2021 [Narzędzia do automatyzacji testów QA]
- Asystent testowania oprogramowania
- Kurs testowania oprogramowania: Do którego Instytutu Testowania Oprogramowania mam dołączyć?
- Wybór testowania oprogramowania jako swojej kariery
- Testowanie oprogramowania Praca Freelancer Writer treści technicznych
- Najlepsze usługi testowania oprogramowania QA od SoftwareTestingHelp
- Rodzaje testowania oprogramowania: różne typy testów ze szczegółami