Il materiale di supporto utente viene in genere richiesto su qualunque sistema disponga di interfaccia con la quale
interagiranno gli utenti; i sistemi che vengono principalmente inclusi e che dispongono di scarsa interfaccia utente,
se non assente, possono ignorare questo prodotto di lavoro, anche se può essere applicabile e utile anche quando devono
essere documentate le API.
Questo prodotto di lavoro spesso include uno o più documenti e prodotti di lavoro fra i seguenti:
-
Guide per l'utente
-
Guide operative
-
Guide alla manutenzione
-
Demo in linea
-
Sistema della guida in linea
-
Guida sensibile al contesto
-
Note sul rilascio
La documentazione per l'utente fornisce le istruzioni per utilizzare il software. Fornisce la documentazione per tutti
i tipi di utenti.
Utilizzare i casi d'uso come base per la guida per l'utente.
Il manuale per l'utente può essere scritto da autori tecnici, con input degli sviluppatori, oppure può essere scritto
dal team di test, i cui membri probabilmente comprendono la prospettiva dell'utente.
Un motivo per assegnare il manuale per l'utente al team di test è che può essere generato in parallelo con lo sviluppo
e può essere utilizzato come una prospettiva tangibile e rilevante dei criteri di valutazione. Gli errori e le
soluzioni scarse nell'interfaccia utente e nel modello di casi d'uso possono essere rilevati e corretti durante le
prime iterazioni del progetto, quando le modifiche sono più economiche.
Scrivendo il manuale per l'utente, i tester conosceranno il sistema molto prima di iniziare qualsiasi fase di verifica
in piena scala. Inoltre, fornisce una base necessaria per i piani di test ed i casi d'uso, e per la creazione di suite
di test automatizzate.
A che punto del ciclo di sviluppo iniziare a produrre il manuale per l'utente dipende dal tipo di sistema. I sistemi
con interfacce complesse o con molta interazione dell'utente richiederanno delle versioni precoci del manuale e anche
dei precoci prototipi di interfaccia. I sistemi inclusi, con scarsa interfaccia probabilmente non richiedono un avvio
precoce della documentazione per l'utente.
|