Menu

Dokumentationsvejledning til softwaretest (hvorfor det er vigtigt)

software testing documentation guide

Prøv Vores Instrument Til At Fjerne Problemer

I min karriere med softwaretest hørte jeg aldrig folk tale meget om dokumentation til softwaretest. Den generelle opfattelse af testdokumentation er, at enhver, der har fritid, kan gøre dokumentationen som en testcase, testplan, statusrapport, fejlrapport, projektforslag osv.

Selv stressede jeg ikke mere med dokumentationen, men jeg kan sige, at det er min vane at placere alle data i sort / hvid og også opdatere andre om det.

Software Testing Dokumentationsvejledning (hvorfor det

Hvad du vil lære:

Min erfaring

Vil bare dele min oplevelse med dig:

Vi havde leveret et projekt (med et ukendt problem i det) til en af ​​vores klienter (vred klient). Og de fandt problemet på en klientside, hvilket var en meget dårlig situation for os, og som sædvanlig var al skyld QA'er.

Spørgsmålet var noget med hensyn til kompatibiliteten af ​​et websted. Da det kom til mig, havde jeg bevis for, at jeg ikke fik et sådant kravsdokument, som siger, at jeg også skal kontrollere webstedets kompatibilitet. Gudskelov var jeg sikker.

Det var lektionen for mig, jeg indså vigtigheden af ​​dokumentation og fra den dag begyndte jeg at arbejde på dokumenter og oprettede testdokumenter som testplan, testsager, checklist til sundhedstest, fejlrapport og mange.

“Blæk er bedre end den bedste hukommelse” - kinesisk ordsprog

Testdokumentation: Hvad er det?

Vi læser alle forskellige artikler om testteknologier og metoder, men hvor mange af os har set artikler om dokumentation? Der er uden tvivl få, er det ikke dokumenter, der er vigtige? Nej, men det er fordi vi endnu ikke har forstået vigtigheden af ​​dokumenter.

Men hvis vi observerer det, er faktum, projekter, der har alle dokumenter, har en høj modenhed.

De fleste virksomheder lægger ikke engang lidt vægt på dokumentationen, så meget de giver softwareudviklingsprocessen. Hvis vi søger på internettet, kan vi finde forskellige skabeloner til, hvordan man opretter forskellige typer dokumenter. Men hvor mange af dem bruges virkelig af organisationer eller enkeltpersoner?

Faktum er, at omhyggelig dokumentation kan spare en organisations tid, indsats og penge.

Mens man går efter enhver form for certificering, hvorfor der lægges vægt på dokumentation, er det bare fordi det viser vigtigheden af ​​klient og processer for individet og organisationen. Medmindre du er i stand til at producere et dokument, der er behageligt for brugeren, uanset hvor godt dit produkt er, vil ingen acceptere det.

Det er min erfaring, vi ejer et produkt, der har lidt forvirrende funktionalitet.

Da jeg begyndte at arbejde på det, bad jeg om nogle hjælpedokumenter til Manager, og jeg fik svaret ”Nej, vi har ingen dokumenter” Derefter lavede jeg et spørgsmål om det, fordi jeg som QA vidste, ingen kan forstå, hvordan man Brug produktet uden dokumenter eller uddannelse. Og hvis brugeren ikke er tilfreds, hvordan tjener vi penge på det produkt?

”Mangel på dokumentation bliver et problem for accept” - Wietse Venema

Selv det samme gælder for brugermanualer. Tag et eksempel på Microsoft, de lancerer hvert produkt med korrekte dokumenter, selv for Office 2007 har vi sådanne dokumenter, som er meget forklarende og lette at forstå for enhver bruger. Det er en af ​​grundene til, at alle deres produkter lykkes.

I små virksomheder har vi altid hørt 'projektafvisning i forslag eller kickoff-fase', det er bare fordi dokumentation i forslag mangler kortfattet og udtryksfuldt sprog og at vise organisationens kapacitet.

Det er ikke, at små virksomheder ikke kan levere projekter af god kvalitet, men det er deres manglende evne til at udtrykke deres evner. (Jeg arbejder også med en lille organisation på 80 ansatte, og jeg har hørt det mange gange)

Jeg føler personligt, at kvalitet er den eneste afdeling, der kan gøre det muligt. Vi er den eneste afdeling, der kan argumentere for dette og kan give vores organisationer en vellykket fremtid.

Lad os organisere alle diskussioner i få punkter i kvalitetsperspektiv:

- Afklare kvalitetsmål og metoder
- Sikre klarhed om opgaver og konsistens i ydeevnen
- Sikre intern koordination i klientarbejde
- Giv feedback om forebyggende handlinger
- Giv feedback til din planlægningscyklus
- Opret objektiv dokumentation for dit kvalitetsstyringssystems ydeevne

10 tip, der hjælper dig med at nå testdokumentationsmål

Som jeg nævnte i mit tidligere indlæg, er forståelse af dokumentation til softwaretest generelt 'Det kan kun gøres af den person, der har fritid'. Vi er nødt til at ændre denne tankegang, og så kun kan vi udnytte dokumentationskraft på vores projekter.

Det er ikke, at vi ikke ved, hvordan man laver dokumentationen rigtigt. Vi synes bare ikke, det er vigtigt.

Alle skal have standardskabeloner til alle slags dokumenter, der starter fra teststrategi, testplan, testsager og testdata til fejlrapporten.

Disse er bare for at følge nogle standarder (CMMI, ISO osv.), Men når det kommer til den faktiske implementering, hvor mange af disse dokumenter bruges der virkelig af os? Vi skal bare synkronisere vores kvalitetsproces med dokumentationsstandarder og en anden proces i en organisation.

Den enkleste ting at følge alle former for dokumentation er at involvere en person i projektet fra startfasen, der forstår projektets dynamik, domæne, mål og teknologi. Og hvem der ellers er bedre end en QA-person til dette (selvfølgelig er der tekniske forfattere til stede for at gøre dette - men overvejer et generelt scenarie med små virksomheder, hvor tekniske forfattere ikke er til stede).

For at nå dette mål med test og dokumentation føler jeg, at vi har brug for at fokusere på nogle punkter.

Her er de 10 bedste tip, der hjælper dig med at nå testdokumentationsmålet:

hvordan man åbner en .xml fil

# 1) QA bør inddrages i projektets allerførste fase, så QA og dokumentation fungerer hånd i hånd.

#to) Den proces, der er defineret af QA, skal følges af tekniske personer, dette hjælper med at fjerne de fleste af manglerne i en meget indledende fase.

# 3) Kun oprettelse og vedligeholdelse Softwaretestskabeloner er ikke nok, tving folk til at bruge dem.

# 4) Opret og efterlad ikke kun dokumentet, opdater efter behov.

# 5) Ændringskrav er en vigtig fase af projektet. Glem ikke at føje dem til listen.

# 6) Brug versionskontrol til alt. Dette hjælper dig med nemt at administrere og spore dine dokumenter.

# 7) Gør afhjælpning af mangler lettere ved at dokumentere alle mangler. Sørg for at medtage en klar beskrivelse af defekten, reproducere trin, det berørte område og detaljer om forfatteren, mens du dokumenterer en defekt.

# 8) Prøv at dokumentere, hvad der kræves for at du kan forstå dit arbejde, og hvad du skal producere til dine interessenter, når det er nødvendigt.

# 9) Brug standardskabelonen til dokumentation. Ligesom enhver excel arkskabelon eller doc-filskabelon, og hold dig til den for alle dine dokumentbehov.

# 10) Del alle projektrelaterede dokumenter på et sted, der er tilgængeligt for alle teammedlemmer til reference, så de også kan opdateres, når det er nødvendigt.

Jeg siger ikke, at ved at anvende trin får du pludselige resultater. Jeg ved, at denne ændring ikke vil ske om en dag eller to, men i det mindste kan vi starte, så disse ændringer begynder at ske langsomt.

Efter alt “dokumentationen har brug for dokumentation”. Er det ikke?

Der er hundredvis af dokumenter, der bruges i softwareudviklingen og testets livscyklus.

Vigtige softwaretestdokumenter

Her nævner jeg nogle vigtige softwaretestdokumenter, som vi har brug for / vedligeholder regelmæssigt:

1) Testplan
2) Test Design og Test Case Specification
3) Teststrategi
4) Testoversigtsrapporter
5) Ugentlig statusrapport
6) Brugerdokumenter / manualer
7) Rapport om brugeraccept
8) Risikovurdering
9) Testlog
10) Fejlrapporter
elleve) Testdata
12) Testanalyse

Desuden skal softwaretestere regelmæssigt henvise til følgende dokumenter:
1) Specifikationer for softwarekrav
2) Funktionelle dokumenter

Konklusion

Software-testdokumenter spiller altid en vigtig rolle i projektudviklings- / testfasen. Så hold altid tingene dokumenteret, når det er muligt. Stol ikke på verbal kommunikation. Vær altid på den sikre side.

Dokumentation sparer ikke kun dig, men hjælper også organisationen på lang sigt med at spare tusindvis af dollars på træning og endnu vigtigere på at løse problemer forårsaget på grund af manglende udviklings- og testdokumenter.

Dokumenter ikke bare for at undgå at pege på dig, men dokumentationsvanen vil helt sikkert bringe en systematisk tilgang til din testproces og efterlade ad hoc-testen.

Om forfatter: Denne artikel er skrevet af STH-teammedlem Tejaswini. Hun arbejder som kvalitetschef i en organisation.

Hvilke andre dokumenter vedligeholder du i dine daglige testaktiviteter?

Anbefalet læsning

^