micrografica, Sabato 04 Settembre 2010
home writings tech writing Gli elementi strutturali del manuale d'uso


Gli elementi strutturali del manuale d'uso
Prima di iniziare con la redazione della documentazione di prodotto è bene impostare il corretto approccio di lavoro.
La maggioranza dei progettisti e techwriters commette l'errore di tuffarsi nella stesura del manuale senza averne prima definita la struttura. Essa può variare molto tra i diversi documenti e in relazione al prodotto da documentare, ma per tutte le situazioni vale il principio di adottare una struttura standard - magari adattata e/o modificata - che comprenda pure le dettagliate peculiarità del prodotto trattato.

Quali sono gli elementi costitutivi del manuale? Gli elementi che vanno a comporre il manuale d'uso possono essere davvero pochissimi, oppure tantissimi il relazione al prodotto ma anche al genere di utenza che si va ad investire per la lettura. Ad esempio, un manuale officina, di impianto, di riparazione potrebbe necessitare di procedure alquanto complesse; un piccolo elettrodomestico, evidentemente, può benissimo essere dotato di istruzioni più che sufficienti già contenute in una mezza paginetta dalla grafica accattivante e ben curata. Entrambe le situazioni richiedono comunque un approccio organizzativo del tutto simile e incentrato sul procedimento "per esclusione", preferibile rispetto al più impreciso metodo "per inclusione" che presuppone un tipo di impostazione non strutturata ed approssimativa.

Gli elementi strutturali del manuale

Si procede con la soddisfazione di precisi requisiti introduttivi:
  • copertina
  • prima pagina (disclaimer, avvertenza "istruzioni originali", lingue del manuale, copyright, ecc.)
  • avvertenze, precauzioni e avvisi generali
  • sommario (da non confondere con l'indice analitico a fine volume)
  • premessa, presentazione del prodotto
si prosegue con il "corpo" vero e proprio delle istruzioni:
  • descrizione del prodotto
  • disimballaggio
  • montaggio e installazione e allacciamenti
  • calibratura e taratura
  • uso
  • risoluzione di problemi/anomalie di funzionamento
  • manutenzione
  • emergenza (solo macchiari complessi)
  • revisione (di solito affrontata con istruzioni a parte)
  • trasporto e smaltimento (solo macchiari complessi o ad es. soggetti a RAEE)
  e la sezione finale:
  • specifiche tecniche
  • informazioni tecniche
  • riferimenti a norme (ove applicabile)
  • lista delle parti di ricambio (facoltativo)
  • glossario
  • indice analitico
  • indice delle illustrazioni e delle tavole
L'ordine espositivo delle informazioni oltre a fornire un palinsesto operativo valido per ogni esigenza, offre una certa garanzia di ordine nella presentazione evitando l'insorgere di situazioni di pericolo e confusione derivanti da un cattivo approccio organizzativo del redattore.
 
Credits © 2010 micrografica sas - 41012 Carpi (MO) Italy - Via della Rosa, 12/c - Codice Fiscale e Partita Iva 02201200363
Condizioni di utilizzo  |  Informazioni sulla privacy
JoomlaWatch 1.2.11 - Joomla Monitor and Live Stats by Matej Koval