RENDERE COMPRENSIBILE ALL'UTENTE LA DOCUMENTAZIONE SOFTWARE

Tutte le persone che utilizzano applicazioni software necessitano di precise informazioni sulle funzionalità dei programmi: davanti ad un nuovo software, il primo approccio dell'utente verso la documentazione tenderà a influenzare la sua impressione relativamente al prodotto che ha acquistato.

Nell'interesse degli utilizzatori, la nuova norma internazionale ISO/IEC 26514:2008 aiuterà i progettisti e gli sviluppatori della documentazione: il documento definisce infatti il processo di documentazione dal punto di vista di chi lo elabora e copre le fasi di progettazione, specifica e produzione della documentazione per l'utente, sia essa cartacea o on-screen.

Elaborata dal comitato tecnico ISO/IEC JTC 1 "Information technology" SC 7 "Software and systems engineering", la ISO/IEC 26514:2008 "Systems and software engineering - Requirements for designers and developers of user documentation si divide in due parti:

• dedicata ai progettisti e agli sviluppatori, la prima parte tratta il processo di creazione della documentazione destinata all'utente.
  Essa descrive come stabilire, presentare, preparare e rendere disponibili le informazioni necessarie per l'utilizzatore; non si limita alla fase di progettazione e sviluppo ma comprende tutte le attività di gestione delle informazioni e la documentazione di processo;
• la seconda parte definisce i requisiti minimi di struttura, i contenuti informativi e il formato della documentazione destinata all'utente, sia per i manuali cartacei che on-screen utilizzati negli ambienti di lavoro che utilizzano sistemi software.
  Questa parte della norma si applica ai manuali stampati, agli aiuti online, alla documentazione di riferimento per l'utente

Secondo quanto riportato nella norma, lo sviluppo della documentazione per l'utente dovrebbe essere parte dello sviluppo del prodotto software e seguire gli stessi processi lungo tutto il ciclo di vita.

La documentazione destinata all'utente resta una componente essenziale dei prodotti software e la norma ISO/IEC 26514 può costituire un utile strumento per sviluppare:

• documentazione di prodotti diversi dal software
• sistemi multimediali con utilizzo di animazione, audio e video
• pacchetti di formazione informatizzata e materiali di formazione specializzati destinati principalmente a programmi di formazione ufficiali
• documentazione di prodotto per installatori, operatori informatici o amministratori di sistema (che non sono gli utenti finali)
• documentazione di manutenzione, che descrive il funzionamento interno dei sistemi software
• documentazione incorporata nell''interfaccia-utente

La ISO/IEC 26514 è la prima di una serie di norme relativa alla documentazione per utenti di software, messa a punto per rispondere alle esigenze dei progettisti e degli sviluppatori; altre tre norme sono in fase di elaborazione e tratteranno le esigenze dei gestori, di acquirenti e fornitori, dei collaudatori e dei valutatori della documentazione.

Per informazioni tecniche:
UNINFO (Ente federato UNI per le Tecnologie Informatiche e loro applicazioni)
tel. 011 501027 - fax 011 501837
e-mail: uninfo@uninfo.polito.it

Per informazioni commerciali:
Diffusione UNI
tel. 02 70024.200, fax 02 5515256
e-mail: diffusione@uni.com

(Fonte: UNI)