Praticar Treinar
Aprender a usar o produto nas operações cotidianas e habituais.
Os usuários precisam aprender a operar a maior parte das áreas de um produto que lhes dizem respeito. Por exemplo, os administradores precisam aprender a criar e remover usuários. A ação Praticar descreve a necessidade de adquirir conhecimento procedimental, isto é, como usar o produto nas operações cotidianas e habituais.
Exemplos de documentação que permite praticar são Gerar uma nova chave SSH (GitHub), Importar contatos para o Mailchimp e Gerenciamento de usuários (Dynatrace). Oferecem diferentes padrões de guias práticos ou tutoriais, com ou sem materiais audiovisuais, todos com o mesmo objetivo de ajudar os usuários a dominar um procedimento.
Quando os usuários conseguem executar tarefas com confiança, é mais provável que explorem funcionalidades avançadas e se tornem defensores do produto. Esse tipo de documentação serve frequentemente de espinha dorsal para programas de capacitação de usuários e trilhas de certificação, transformando conhecimento teórico em competência prática.
O que o usuário quer fazer
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.
Sinais de que a documentação não atende a essa necessidade
- As mesmas perguntas sobre como fazer algo se repetem nos canais de suporte e da comunidade.
- Os procedimentos existem apenas como conhecimento informal ou na cabeça de alguém.
- Não existe um guia passo a passo para tarefas administrativas comuns.
Dois exemplos reais
Tipos de conteúdo comuns
| DITA | Diátaxis | Good Docs Project |
|---|---|---|
| <task>, <step>, <choicetable> | Guia prático | Guia prático |
Uma métrica
sucesso da tarefa · Proporção de usuários que concluem um procedimento padrão sem suporte.