Documentația de testare în testarea software-ului (exemplu)

Ce este documentația de testare?

Documentația de testare este o documentație a artefactelor create înainte sau în timpul testării software-ului. Aceasta ajută echipa de testare să estimeze efortul necesar, să urmărească resursele și progresul și să asigure o acoperire adecvată a testelor. Înregistrarea și rapoartele testului sunt o suită completă de documente care vă permit să descrieți și să documentați planificarea testelor, proiectarea testelor, execuția testelor și rezultatele testelor extrase din activitatea de testare.

👉 Înscrie-te pentru un proiect gratuit de testare software live

De ce este nevoie de formalitate a testelor?

Pentru un începător, este ușor să presupună că testarea înseamnă executarea diferitelor secțiuni de cod ad-hoc și verificarea rezultatelor. Dar în lumea reală, testarea este o activitate foarte formală și este documentată în detaliu. Documentația testelor face planificarea, revizuirea și executarea testării ușoare, precum și verificabile.

Gradul de formalitate al testului depinde de:

• Tipul aplicației testate (AUT).
• Standarde urmate de organizația dvs.
• Maturitatea procesului de dezvoltare.

Activitățile de testare consumă de obicei între 30% și 50% din efortul total de dezvoltare software. Documentațiile ajută la identificarea îmbunătățirilor procesului de testare care pot fi aplicate proiectelor viitoare.

Care sunt tipurile de documentație de testare?

Iată tipurile importante de documentație de testare:

„În practică, aceste documente sunt create în diferite etape — de la planificarea inițială (politica de testare, strategia) până la execuție și închidere (rapoarte de defecte și sumarizare).”

Tipuri de documente de testare	Descriere
Politica de testare	Este un document de nivel înalt care descrie principiile, metodele și toate obiectivele importante de testare ale organizației.
Strategia de testare	Un document de nivel înalt care identifică nivelurile (tipurile) de testare care trebuie executate pentru proiect.
Planul de testare	Un plan de testare este un document complet de planificare care conține domeniul de aplicare, abordarea, resursele, programul etc. al activităților de testare.
Cerințe Matricea de trasabilitate	Acesta este un document care leagă cerințele de cazurile de testare.
Scenariu de testare	Scenariu de testare este un element sau eveniment al unui sistem software care poate fi verificat prin unul sau mai multe cazuri de testare.
Caz de testare	Este un grup de valori de intrare, precondiții de execuție, postcondiții de execuție așteptate și rezultate. Este dezvoltat pentru un scenariu de testare.
Date de testare	Datele de test sunt date care există înainte de executarea unui test. Acestea sunt utilizate pentru a executa cazul de testare.
Raport defect	Un raport de defecte este un raport documentat al oricărei defecțiuni dintr-un sistem software care nu își îndeplinește funcția așteptată.
Raport rezumat al testului	Raportul sumar al testului este un document de nivel înalt care rezumă activitățile de testare efectuate, precum și rezultatele testelor.

Care sunt cele mai bune practici pentru realizarea documentației de testare?

În această secțiune, vom afla despre cele mai bune practici care ajută la realizarea documentației de testare, cu exemple care să vă ajute să o înțelegeți mai bine:

• Implică asigurarea calității încă de la începutul proiectului: Includeți echipa de asigurare a calității încă de la începutul proiectului, astfel încât documentația de testare să se dezvolte odată cu designul produsului și cerințele.
  Exemplu: Echipa de asigurare a calității (QA) colaborează în timpul planificării sprintului pentru a redacta cazurile de testare inițiale pe baza poveștilor utilizatorilor.
• Mențineți documentele actualizate: Nu creați pur și simplu documente de testare și apoi uitați de ele — actualizați-le ori de câte ori se schimbă cerințele sau caracteristicile.
  Exemplu: Când o API de conectare se modifică, actualizați imediat cazurile de testare și rezultatele aferente.
• Utilizați Controlul versiunii: Gestionați și urmăriți toate modificările aduse documentelor de testare prin intermediul sistemelor de control al versiunilor pentru a evita confuzia și pierderea de date.
  Exemplu: Stocați planurile de testare în GitHub pentru a menține un istoric clar al versiunilor și opțiuni de revenire la versiunea inițială.
• Document pentru claritate și scop: Înregistrați doar ceea ce vă ajută pe dumneavoastră și pe părțile interesate să înțelegeți progresul testării și rezultatele așteptărilor.
  Exemplu: Includeți rapoarte sumarizate de testare care evidențiază cazurile de testare reușite, eșuate și blocate pentru revizuirea de către management.
• Folosește șabloane standard: Urmați un format consistent — cum ar fi șabloane Excel sau Word — pentru a facilita crearea și revizuirea documentației.
  Exemplu: Folosește un „șablon de caz de testare” standard cu câmpuri pentru ID, descriere, precondiții și rezultate așteptate.
• Centralizați stocarea documentelor: Păstrați toate documentele legate de proiect într-un singur loc accesibil pentru a vă asigura că membrii echipei le pot consulta sau actualiza cu ușurință.
  Exemplu: Stocați artefactele de testare într-un spațiu partajat Google Drive dosar accesibil întregii echipe de control al calității și de dezvoltare.
• Includeți suficiente detalii: Evitați informațiile vagi sau incomplete; documentația detaliată îmbunătățește înțelegerea și reduce erorile în timpul executării testelor.
  Exemplu: În loc de „Verificare conectare”, scrieți „Verificarea conectării utilizatorului cu acreditări valide redirecționează către tabloul de bord cu succes”.

Când ar trebui să creați documentația de testare pentru testarea software?

Iată câteva dintre punctele cheie legate de momentul în care ar trebui să creați documentația de testare pentru testarea software-ului:

• Etapa de planificare: Înainte de începerea execuției testelor, este necesar să se definească clar domeniul de aplicare, obiectivele și strategia de testare.
• Pregatire pentru test: În timpul planificării testelor, pentru a stabili eficient cronologiile, resursele și cerințele de mediu.
• Analiza cerințelor: După analiza cerințelor, pentru a asigura acoperirea completă a specificațiilor funcționale și nefuncționale.
• Standardizare a designului: Înainte de a proiecta cazuri de testare, pentru a standardiza formatele și a menține trasabilitatea în toate documentele.
• Documentația scenariului: În timpul proiectării testelor, pentru a documenta scenariile, intrările, rezultatele așteptate și detaliile datelor de testare.
• Pregătire pentru execuție: Înainte de executarea testului, pentru a verifica pregătirea mediului de testare, a instrumentelor și acuratețea documentației.
• Evaluare ulterioară: După testare, pentru a înregistra rezultatele, defectele și lecțiile învățate pentru îmbunătățirea procesului.

Ce tipuri de șabloane sunt necesare pentru documentația de testare?

Iată câteva dintre șabloanele de care aveți nevoie pentru documentația de testare în testarea software:

Nume șablon	Instrumente
Șablon de plan de testare	Microsoft Word, Google Docs sau Confluence pentru editare colaborativă și control al versiunilor
Șablon de caz de testare	TestRail, Zephyr (în JIRA), Xray sau Excel/Google Sheets pentru gestionarea structurată a testelor
Șablon de scenariu de testare	JIRA, TestLink sau Google Sheets pentru documentarea condițiilor de testare la nivel înalt
Șablon Matrice de Trasabilitate a Cerințelor (RTM)	Excel, Google Sheets sau TestRail pentru corelarea cerințelor cu cazurile de testare
Șablon de raport de defecte	JIRA, Bugzilla sau Azure DevOps pentru înregistrarea și urmărirea defectelor
Șablon de raport pentru rezumatul testului	Confluenţă, Google Docs sau TestRail pentru compilarea rezultatelor testelor și a analizelor

Avantaje și dezavantaje ale documentației de testare

Pro

• Principalul motiv pentru crearea documentației de testare este fie reducerea, fie eliminarea oricăror incertitudini legate de activitățile de testare. Aceasta ajută la eliminarea ambiguității, care apare adesea atunci când vine vorba de alocarea sarcinilor.
• Documentarea nu oferă doar o abordare sistematică a testare software, dar acționează și ca material de instruire pentru cei care sunt în curs de dezvoltare în procesul de testare a software-ului.
• Prezentarea documentației de testare pentru a demonstra un proces de testare matur servește ca o strategie bună de marketing și vânzări.
• Documentația de testare vă ajută să oferiți clientului un produs de calitate în termenele stabilite.
• In Inginerie SoftwareDocumentația de testare ajută și la configurarea sau configurarea programului prin intermediul documentului de configurare și al manualelor de utilizare.
• Documentația de testare vă ajută să îmbunătățiți transparența cu clientul.

Contra

• Costul documentației poate depăși valoarea acesteia, deoarece necesită foarte mult timp.
• De multe ori, este scris de oameni care nu pot scrie bine sau care nu cunosc materialul.
• Urmărirea modificărilor solicitate de client și actualizarea documentelor corespunzătoare este obositoare.
• O documentație deficitară reflectă direct calitatea produsului, deoarece poate apărea o neînțelegere între client și organizație.

Greșeli frecvente de evitat în documentația de testare

Iată cele mai frecvente greșeli pe care ar trebui să le evitați în documentația unui test:

1. Evitați să scrieți descrieri neclare sau ambigue ale cazurilor de testare.
2. Nu săriți peste documentarea precondițiilor de testare și a dependențelor.
3. Nu uita niciodată să incluzi rezultatele așteptate pentru fiecare test.
4. Evitați formatarea inconsistentă între diferite documente de testare.
5. Nu utilizați obiective de testare vagi sau nemăsurabile.
6. Nu omiteți niciodată controlul versiunilor pentru actualizările documentației de testare.
7. Evitați duplicarea informațiilor pe mai multe artefacte de testare.
8. Nu neglijați revizuirea documentației pentru acuratețe și completitudine.

Întrebări frecvente