Glossário

Ações

Avaliar Discernir

Discernir as principais qualidades do produto e, se for o caso, compará-lo com outros. Os usuários da documentação são também potenciais clientes ou adotantes. 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 se baseiam em abstrações difíceis de compreender, mas fundamentais para o uso correto. A documentação conceitual consolida o aprendizado ao lado da exploração e da prática.

Explorar Descobrir

Experimentar o produto e descobrir o que ele faz, com uma barreira de entrada baixa. Os grandes produtos convidam os usuários 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 usar o produto nas operações cotidianas e habituais. Os usuários precisam aprender a usar a maior parte das áreas de um produto. Praticar descreve a necessidade de adquirir conhecimento procedimental: como usar o produto nas operações cotidianas e habituais.

Recordar Relembrar

Relembrar informações que não foi possível memorizar, de parâmetros a códigos de erro. O material de referência mantém a documentação viva depois de anos de uso. Os usuários consultam 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 usuários precisam com frequência construir sobre produtos existentes, ampliá-los ou integrá-los, por meio 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. Esbarrar em problemas — configurações incorretas, casos extremos ou erros reais — é comum. A resolução de problemas representa a necessidade de diagnosticá-los e resolvê-los de forma eficiente, muitas vezes sob pressão, quando os sistemas falham ou os prazos se aproximam.