Glossario

Azioni

Valutare Discernere

Discernere le qualità principali del prodotto e, se opportuno, confrontarlo con altri. Gli utenti della documentazione sono anche potenziali clienti o persone interessate ad adottare il prodotto. Chi legge deve poter discernere le qualità principali del prodotto e confrontarlo con altri. È un processo di scoperta.

Comprendere Imparare

Comprendere le astrazioni e i modelli mentali su cui si basa il prodotto. I prodotti software si basano su astrazioni difficili da comprendere ma fondamentali per un uso corretto. La documentazione concettuale consolida ciò che si apprende durante l’esplorazione e l’esercitazione.

Esplorare Scoprire

Provare il prodotto e scoprirne le possibilità con una bassa barriera all’ingresso. I grandi prodotti invitano gli utenti a interagire e a provare cose nuove. La documentazione dovrebbe offrire suggerimenti, istruzioni e possibilità di azione che facilitino l’esplorazione come una delle prime attività.

Esercitarsi Allenarsi

Imparare a utilizzare il prodotto nelle attività quotidiane e ordinarie. Gli utenti devono imparare a utilizzare la maggior parte delle aree di un prodotto. Esercitarsi descrive l’esigenza di acquisire conoscenze procedurali: come usare il prodotto nelle attività quotidiane e ordinarie.

Ricordare Richiamare

Richiamare informazioni che non si possono memorizzare, dai parametri ai codici di errore. Il materiale di riferimento mantiene viva la documentazione anche dopo anni di utilizzo. Gli utenti sfogliano i manuali per ricordare, richiamare, recuperare o cercare informazioni che non hanno potuto memorizzare.

Sviluppare Integrare

Costruire sul prodotto, estenderlo o integrarlo per creare ulteriore valore. Gli utenti hanno spesso bisogno di costruire su prodotti esistenti, estenderli o integrarli, tramite integrazioni, estensioni, plugin o applicazioni completamente nuove. L’obiettivo è quasi sempre pragmatico.

Risolvere Diagnosticare

Diagnosticare e risolvere i problemi in modo efficiente, spesso sotto pressione. Imbattersi in problemi — configurazioni errate, casi limite o veri e propri bug — è comune. La risoluzione dei problemi rappresenta l’esigenza di diagnosticarli e risolverli in modo efficiente, spesso sotto pressione quando i sistemi non funzionano o le scadenze incombono.