software testing documentation guide
Nella mia carriera nel test del software, non ho mai sentito parlare molto della documentazione del test del software. L'opinione generale sulla documentazione di test è che chiunque abbia tempo libero può fare la documentazione come un caso di test, un piano di test, un rapporto sullo stato, un rapporto sui bug, una proposta di progetto, ecc.
Anche io non ho insistito di più sulla documentazione, ma posso dire che è mia abitudine mettere tutti i dati in bianco e nero e aggiornare anche gli altri su questo.
Cosa imparerai:
- La mia esperienza
- Documentazione del test: che cos'è?
- 10 suggerimenti per aiutarti a raggiungere l'obiettivo della documentazione del test
- Documenti importanti per il test del software
- Conclusione
- Lettura consigliata
La mia esperienza
Voglio solo condividere la mia esperienza con te:
miglior ottimizzatore di sistema per Windows 10
Avevamo consegnato un progetto (con un problema sconosciuto in quello) a uno dei nostri clienti (cliente arrabbiato). E hanno riscontrato il problema dal lato client, che era una situazione molto brutta per noi e, come al solito, tutta la colpa era del QA.
Il problema riguardava la compatibilità di un sito web. Quando è arrivato da me, stavo avendo la prova che non avevo ricevuto un tale documento di requisiti che afferma che devo controllare anche la compatibilità del sito web. Grazie a Dio ero al sicuro.
Questa è stata la lezione per me, ho capito l'importanza della documentazione e da quel giorno ho iniziato a lavorare sui documenti e ho creato documenti di test come il piano di test, i casi di test, la lista di controllo del test di sanità mentale, la segnalazione di bug e molti altri.
'L'inchiostro è meglio della migliore memoria' - proverbio cinese
Documentazione del test: che cos'è?
Abbiamo letto tutti vari articoli sui test di tecnologie e metodi, ma quanti di noi hanno visto articoli sulla documentazione? Senza dubbio ce ne sono pochi, è che i documenti non sono importanti? No, ma è perché non ci siamo ancora resi conto dell'importanza dei documenti.
Ma, se osserviamo, il fatto è che i progetti che hanno tutti i documenti hanno un alto livello di maturità.
La maggior parte delle aziende non dà nemmeno una piccola importanza alla documentazione, tanto quanto dà al processo di sviluppo del software. Se cerchiamo sul web, possiamo trovare vari modelli su come creare vari tipi di documenti. Ma quanti di loro sono realmente utilizzati da organizzazioni o individui?
Il fatto è che un'attenta documentazione può far risparmiare tempo, sforzi e denaro a un'organizzazione.
Mentre si cerca qualsiasi tipo di certificazione, il motivo per cui viene data importanza alla documentazione è solo perché mostra l'importanza del cliente e dei processi per l'individuo e l'organizzazione. A meno che tu non sia in grado di produrre un documento che sia comodo per l'utente, non importa quanto sia buono il tuo prodotto, nessuno lo accetterà.
È la mia esperienza, possediamo un prodotto, che presenta funzionalità un po 'confuse.
Quando ho iniziato a lavorare su questo, ho chiesto alcuni documenti di aiuto al Manager e ho ottenuto la risposta 'No, non abbiamo alcun documento' Quindi ho sollevato un problema perché come QA che conoscevo, nessuno può capire come utilizzare il prodotto senza documenti o formazione. E se l'utente non è soddisfatto, come faremo a guadagnare con quel prodotto?
'La mancanza di documentazione sta diventando un problema per l'accettazione' - Wietse Venema
Anche la stessa cosa è applicabile ai manuali utente. Prendiamo un esempio di Microsoft, lanciano ogni prodotto con documenti adeguati, anche per Office 2007 abbiamo tali documenti, che sono molto esplicativi e di facile comprensione per qualsiasi utente. Questo è uno dei motivi per cui tutti i loro prodotti hanno successo.
Nelle piccole aziende, abbiamo sempre sentito dire 'progetti rifiutati in fase di proposta o di avvio' è solo perché la documentazione della proposta manca di un linguaggio conciso ed espressivo e per mostrare le capacità dell'organizzazione.
Non è che le piccole aziende non possano fornire progetti di buona qualità, ma è la loro incapacità di esprimere le proprie capacità. (Anch'io lavoro con una piccola organizzazione di 80 dipendenti e l'ho sentito molte volte)
Personalmente ritengo che la Qualità sia l'unico dipartimento che può renderlo possibile. Siamo l'unico dipartimento che può discutere su questo e può fornire un futuro di successo alle nostre organizzazioni.
Organizziamo tutta la discussione in pochi punti in una prospettiva di qualità:
- Chiarire obiettivi e metodi di qualità
- Garantire chiarezza sui compiti e coerenza delle prestazioni
- Garantire il coordinamento interno nel lavoro del cliente
- Fornire feedback sulle azioni preventive
- Fornisci feedback per il tuo ciclo di pianificazione
- Crea prove oggettive delle prestazioni del tuo sistema di gestione della qualità
10 suggerimenti per aiutarti a raggiungere l'obiettivo della documentazione del test
Come ho accennato nel mio post precedente, in generale, la comprensione della documentazione di test del software è 'Può essere fatto solo dalla persona che ha tempo libero'. Dobbiamo cambiare questa mentalità e solo allora possiamo sfruttare il potere della documentazione sui nostri progetti.
Non è che non sappiamo come fare la documentazione giusta. Semplicemente non pensiamo che sia importante.
Tutti devono avere modelli standard per tutti i tipi di documentazione, a partire da Strategia di test, Piano di test, Casi di test e Dati di test fino alla segnalazione di bug.
Questi sono solo per seguire alcuni standard (CMMI, ISO, ecc.) Ma quando si tratta dell'effettiva implementazione quanti di questi documenti sono realmente utilizzati da noi? Abbiamo solo bisogno di sincronizzare il nostro processo di qualità con gli standard di documentazione e un altro processo in un'organizzazione.
La cosa più semplice da seguire tutti i tipi di documentazione è coinvolgere nel progetto una persona fin dalla fase di avvio che comprende le dinamiche, il dominio, l'obiettivo e la tecnologia del progetto. E chi altro meglio di una persona QA per questo (ovviamente ci sono scrittori tecnici presenti per farlo, ma considerando uno scenario generale di piccole aziende in cui non sono presenti scrittori tecnici).
Per raggiungere questo obiettivo di test e documentazione sento che dobbiamo concentrarci su alcuni punti.
Ecco i 10 migliori suggerimenti per aiutarti a raggiungere l'obiettivo della documentazione del test:
# 1) Il controllo qualità dovrebbe coinvolgere la prima fase del progetto in modo che il controllo qualità e la documentazione lavorino mano nella mano.
#Due) Il processo definito da QA dovrebbe essere seguito da personale tecnico, questo aiuta a rimuovere la maggior parte dei difetti in una fase iniziale.
# 3) Solo creare e mantenere Modelli di test del software non basta, costringere le persone a usarli.
# 4) Non solo creare e lasciare il documento, aggiorna come e quando richiesto.
# 5) Il requisito del cambiamento è una fase importante del progetto, non dimenticare di aggiungerli all'elenco.
# 6) Usa il controllo della versione per tutto. Questo ti aiuterà a gestire e monitorare facilmente i tuoi documenti.
# 7) Semplifica il processo di riparazione dei difetti documentando tutti i difetti. Assicurati di includere una chiara descrizione del difetto, riprodurre i passaggi, l'area interessata e i dettagli sull'autore mentre documenti qualsiasi difetto.
# 8) Cerca di documentare ciò che ti è richiesto per comprendere il tuo lavoro e ciò che dovrai produrre ai tuoi stakeholder ogni volta che sarà necessario.
# 9) Usa il modello standard per la documentazione. Come qualsiasi modello di foglio Excel o modello di file doc e rispettalo per tutte le esigenze dei tuoi documenti.
# 10) Condividi tutti i documenti relativi al progetto in un'unica posizione, accessibile a ogni membro del team per riferimento e per aggiornarli ogni volta che è necessario.
Non sto dicendo che applicando i passaggi otterrai risultati improvvisi. So che questo cambiamento non avverrà in un giorno o due, ma almeno possiamo iniziare in modo che questi cambiamenti inizino ad avvenire lentamente.
Dopo tutto 'la documentazione ha bisogno di documentazione'. Non è vero?
Esistono centinaia di documenti utilizzati nello sviluppo del software e nel ciclo di vita dei test.
Documenti importanti per il test del software
Qui sto elencando alcuni importanti documenti di test del software che dobbiamo usare / mantenere regolarmente:
1) Piano di test
2) Test Design e Specifiche dello scenario di test
3) Strategia di test
4) Rapporti di riepilogo dei test
5) Rapporto settimanale sullo stato
6) Documenti / manuali utente
7) Rapporto di accettazione dell'utente
8) Valutazione del rischio
9) Registro di prova
10) Segnalazioni di bug
undici) Dati di test
12) Analisi del test
Inoltre, i tester del software devono fare regolarmente riferimento ai seguenti documenti:
1) Specifiche dei requisiti software
2) Documenti funzionali
Conclusione
I documenti di test del software giocano sempre un ruolo importante nella fase di sviluppo / test del progetto. Quindi tieni sempre le cose documentate quando possibile. Non fare affidamento sulla comunicazione verbale. Sii sempre al sicuro.
La documentazione non solo ti farà risparmiare, ma aiuterà anche l'organizzazione a risparmiare migliaia di dollari sulla formazione e, soprattutto, sulla risoluzione dei problemi causati dalla mancanza di documenti di sviluppo e test.
Non documentare solo per evitare di puntare il dito contro di te, ma l'abitudine alla documentazione porterà sicuramente un approccio sistematico al tuo processo di test, lasciandoti alle spalle i test ad hoc.
Circa l'autore: Questo articolo è stato scritto da un membro del team STH Tejaswini. Lavora come responsabile QA in un'organizzazione.
Quali altri documenti conservi nelle tue attività quotidiane di test?
Lettura consigliata
- Come scrivere un rapporto sullo stato settimanale del test del software
- Migliori strumenti di test del software 2021 [Strumenti di automazione del test QA]
- Lavoro assistente QA test software
- Corso di test del software: quale istituto di test del software dovrei iscrivermi?
- Scegliere il test del software come carriera
- Lavoro di freelance di scrittore di contenuti tecnici di test del software
- I migliori servizi di test del software QA di SoftwareTestingHelp
- Tipi di test del software: diversi tipi di test con dettagli