Glossário

Ações

Avaliar Discernir

Discernir as principais qualidades do produto e, se for caso disso, compará-lo com outros. Os utilizadores da documentação são também potenciais clientes ou avaliadores. Quem lê deve conseguir discernir as principais qualidades do produto e compará-lo com outros. Trata-se de um processo de descoberta.

Compreender Aprender

Compreender as abstrações e os modelos mentais em que o produto se baseia. Os produtos de software baseiam-se em abstrações difíceis de compreender, mas fundamentais para uma utilização correta. A documentação conceptual consolida a aprendizagem ao lado da exploração e da prática.

Explorar Descobrir

Experimentar o produto e descobrir o que é possível fazer com uma baixa barreira à entrada. Os grandes produtos convidam os utilizadores a interagir e a experimentar coisas novas. A documentação deve oferecer pistas, instruções e possibilidades de ação que facilitem a exploração como uma das primeiras atividades.

Praticar Treinar

Aprender a utilizar o produto nas operações quotidianas e habituais. Os utilizadores têm de aprender a utilizar a maior parte das áreas de um produto. Praticar descreve a necessidade de adquirir conhecimento processual: como usar o produto nas operações quotidianas e habituais.

Recordar Relembrar

Relembrar informações que não foi possível memorizar, desde parâmetros até códigos de erro. O material de referência mantém a documentação viva após anos de utilização. Os utilizadores consultam os manuais para recordar, relembrar, recuperar ou procurar informações que não conseguiram memorizar.

Desenvolver Integrar

Construir sobre o produto, ampliá-lo ou integrá-lo para criar valor adicional. Os utilizadores precisam frequentemente de construir sobre produtos existentes, ampliá-los ou integrá-los, através de integrações, extensões, plugins ou aplicações totalmente novas. O objetivo é quase sempre pragmático.

Resolver Solucionar

Diagnosticar e resolver problemas de forma eficiente, muitas vezes sob pressão. Deparar-se com configurações incorretas, casos extremos ou erros reais é comum. A resolução de problemas representa a necessidade de os diagnosticar e resolver de forma eficiente, muitas vezes sob pressão, quando os sistemas falham ou os prazos se aproximam.