Testna dokumentacija u testiranju softvera (primjer)

Što je testna dokumentacija?

Dokumentacija testiranja je dokumentacija artefakata stvorenih prije ili tijekom testiranja softvera. Pomaže timu za testiranje da procijeni potreban napor, prati resurse i napredak te osigura odgovarajuću pokrivenost testiranjem. Zapis i izvješća o testiranju su cjelovit skup dokumenata koji vam omogućuju opisivanje i dokumentiranje planiranja testiranja, dizajna testiranja, izvršenja testiranja i rezultata testiranja koji su izvučeni iz aktivnosti testiranja.

👉 Prijavite se za besplatni projekt testiranja softvera uživo

Zašto je potrebna formalnost testiranja?

Za početnika je lako pretpostaviti da je testiranje izvršavanje različitih dijelova koda na ad-hoc osnovi i provjera rezultata. Ali u stvarnom svijetu, testiranje je vrlo formalna aktivnost i detaljno je dokumentirana. Dokumentacija testiranja olakšava, a ujedno i provjerava planiranje, pregled i izvršavanje testiranja.

Stupanj formalnosti testiranja ovisi o:

• Vrsta aplikacije koja se testira (AUT).
• Standardi koje slijedi vaša organizacija.
• Zrelost razvojnog procesa.

Aktivnosti testiranja obično traju između 30% i 50% ukupnog napora razvoja softvera. Dokumentacija pomaže u identificiranju poboljšanja procesa testiranja koja se mogu primijeniti na buduće projekte.

Koje su vrste testne dokumentacije?

Evo važnih vrsta testne dokumentacije:

„U praksi se ovi dokumenti stvaraju u različitim fazama - od ranog planiranja (politika testiranja, strategija) do izvršenja i zatvaranja (izvješća o nedostacima i sažeci).“

Vrste dokumenata o ispitivanju	Description
Politika testiranja	To je dokument visoke razine koji opisuje principe, metode i sve važne ciljeve testiranja organizacije.
Testirajte strategiju	Dokument visoke razine koji identificira razine (vrste) testiranja koje treba izvršiti za projekt.
Plan ispitivanja	Plan testiranja je cjeloviti dokument planiranja koji sadrži opseg, pristup, resurse, raspored itd. aktivnosti testiranja.
Matrica sljedivosti zahtjeva	Ovo je dokument koji povezuje zahtjeve s testnim slučajevima.
Testni scenarij	Testni scenarij je stavka ili događaj softverskog sustava koji se može provjeriti pomoću jednog ili više testnih slučajeva.
Testni slučaj	To je skup ulaznih vrijednosti, preduvjeta izvršenja, očekivanih naknadnih uvjeta izvršenja i rezultata. Razvijen je za testni scenarij.
Podaci o ispitivanju	Testni podaci su podaci koji postoje prije izvršavanja testa. Koriste se za izvršavanje testnog slučaja.
Izvješće o kvaru	Izvješće o grešci je dokumentirano izvješće o bilo kojoj grešci u softverskom sustavu koja ne obavlja svoju očekivanu funkciju.
Izvješće o sažetku ispitivanja	Sažetak izvješća o testiranju je dokument visoke razine koji sažima provedene aktivnosti testiranja kao i rezultate testiranja.

Koje su najbolje prakse za postizanje dokumentacije testiranja?

U ovom odjeljku saznat ćemo o najboljim praksama koje pomažu u postizanju dokumentacije testiranja s primjerima koji će vam pomoći da je bolje razumijete:

• Uključite QA rano u projekt: Uključite QA tim od samog početka projekta kako bi se dokumentacija za testiranje razvijala uz dizajn proizvoda i zahtjeve.
  Primjer: QA surađuje tijekom planiranja sprinta kako bi izradio početne testne slučajeve na temelju korisničkih priča.
• Održavajte dokumente ažurnima: Nemojte samo stvarati testne dokumente i zaboraviti na njih – ažurirajte ih kad god se promijene zahtjevi ili značajke.
  Primjer: Kada se promijeni API za prijavu, odmah ažurirajte povezane testne slučajeve i rezultate.
• Koristite kontrolu verzija: Upravljajte i pratite sve promjene u testnim dokumentima putem sustava za kontrolu verzija kako biste izbjegli zbrku i gubitak podataka.
  Primjer: Pohranite planove testiranja u GitHubu kako biste održali jasnu povijest verzija i mogućnosti vraćanja na prethodno stanje.
• Dokument za jasnoću i svrhu: Zabilježite samo ono što vama i vašim dionicima pomaže da razumijete napredak testiranja i rezultate.
  Primjer: Uključite sažeta izvješća o testiranju koja ističu uspješne, neuspješne i blokirane testne slučajeve za pregled uprave.
• Koristite standardne predloške: Slijedite dosljedan format - kao što su predlošci za Excel ili Word - kako biste olakšali izradu i pregled dokumentacije.
  Primjer: Koristite standardni "Predložak testnog slučaja" s poljima za ID, opis, preduvjete i očekivane rezultate.
• Centralizirajte pohranu dokumenata: Sve dokumente vezane uz projekt držite na jednom pristupačnom mjestu kako biste osigurali da ih članovi tima mogu lako pregledati ili ažurirati.
  Primjer: Pohranite artefakte testiranja u zajedničkom Google Drive mapa dostupna cijelom QA i razvojnom timu.
• Uključite dovoljno detalja: Izbjegavajte nejasne ili nepotpune informacije; detaljna dokumentacija poboljšava razumijevanje i smanjuje pogreške tijekom izvođenja testa.
  Primjer: Umjesto „Provjeri prijavu“, napišite „Provjera prijave korisnika s valjanim vjerodajnicama uspješno preusmjerava na nadzornu ploču“.

Kada trebate izraditi testnu dokumentaciju za testiranje softvera?

Evo nekih ključnih točaka o tome kada biste trebali izraditi testnu dokumentaciju za testiranje softvera:

• Faza planiranja: Prije početka izvršavanja testiranja, jasno definirati opseg, ciljeve i strategiju testiranja.
• Priprema testa: Tijekom planiranja testiranja, učinkovito utvrditi vremenske rokove, resurse i zahtjeve okruženja.
• Analiza zahtjeva: Nakon analize zahtjeva, osigurati potpunu pokrivenost funkcionalnih i nefunkcionalnih specifikacija.
• Standardizacija dizajna: Prije dizajniranja testnih slučajeva, standardizirati formate i održati sljedivost u svim dokumentima.
• Dokumentacija scenarija: Tijekom dizajna testiranja, dokumentirati scenarije, ulaze, očekivane izlaze i detalje podataka testiranja.
• Spremnost za izvršenje: Prije izvođenja testiranja, provjeriti spremnost testnog okruženja, alata i točnost dokumentacije.
• Evaluacija nakon završetka: Nakon testiranja, zabilježiti rezultate, nedostatke i naučene lekcije za poboljšanje procesa.

Koje su vrste predložaka potrebne za testnu dokumentaciju?

Evo nekih predložaka koji su vam potrebni za testnu dokumentaciju u testiranju softvera:

Naziv predloška	Alati
Predložak plana testiranja	Microsoft Word, Google Docs ili Confluence za kolaborativno uređivanje i kontrolu verzija
Predložak testnog slučaja	TestRail, Zephyr (u JIRA-i), Xray ili Excel/Google tablice za strukturirano upravljanje testovima
Predložak scenarija testiranja	JIRA, TestLink ili Google tablice za dokumentiranje uvjeta testiranja visoke razine
Predložak matrice sljedivosti zahtjeva (RTM)	Excel, Google tablice ili TestRail za mapiranje zahtjeva na testne slučajeve
Predložak izvješća o nedostacima	JIRA, Bugzilla ili Azure DevOps za evidentiranje i praćenje nedostataka
Predložak izvješća o sažetku testiranja	Ušće, Google Docs ili TestRail za sastavljanje rezultata testiranja i analizu

Prednosti i nedostaci testne dokumentacije

Prednosti

• Glavni razlog stvaranja testne dokumentacije je smanjenje ili uklanjanje bilo kakvih nesigurnosti oko aktivnosti testiranja. Pomaže u uklanjanju dvosmislenosti, koja se često javlja kada je u pitanju dodjela zadataka.
• Dokumentacija ne samo da nudi sustavan pristup testiranje softvera, ali također služi kao materijal za obuku početnicima u procesu testiranja softvera.
• Služi kao dobra marketinška i prodajna strategija za predstavljanje testne dokumentacije kako bi se pokazao zreo proces testiranja.
• Testna dokumentacija vam pomaže da klijentu ponudite kvalitetan proizvod unutar određenih vremenskih ograničenja.
• In Programsko inženjerstvo, testna dokumentacija također pomaže u konfiguriranju ili postavljanju programa putem konfiguracijskog dokumenta i priručnika za uporabu.
• Testna dokumentacija vam pomaže poboljšati transparentnost s klijentom.

Nedostaci

• Trošak dokumentacije može premašiti njezinu vrijednost jer oduzima puno vremena.
• Često ga pišu ljudi koji ne znaju dobro pisati ili ne poznaju gradivo.
• Praćenje promjena koje klijent zahtijeva i ažuriranje odgovarajućih dokumenata je zamorno.
• Loša dokumentacija izravno odražava kvalitetu proizvoda, jer može doći do nesporazuma između klijenta i organizacije.

Uobičajene pogreške koje treba izbjegavati u testnoj dokumentaciji

Evo najčešćih pogrešaka koje biste trebali izbjegavati u testnoj dokumentaciji:

1. Izbjegavajte pisanje nejasnih ili dvosmislenih opisa testnih slučajeva.
2. Ne preskačite dokumentiranje preduvjeta i ovisnosti testiranja.
3. Nikada ne zaboravite uključiti očekivane rezultate za svaki test.
4. Izbjegavajte nedosljedno formatiranje u različitim testnim dokumentima.
5. Nemojte koristiti nejasne ili nemjerljive ciljeve testiranja.
6. Nikada ne izostavljajte kontrolu verzija za ažuriranja testne dokumentacije.
7. Izbjegavajte dupliciranje informacija na više testnih artefakata.
8. Ne zanemarite pregled dokumentacije radi točnosti i potpunosti.

Pitanja i odgovori