Explorar Descobrir
Experimentar o produto e descobrir o que é possível fazer com uma baixa barreira à entrada.
Um produto é bem concebido quando a barreira à utilização é baixa. 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 do produto como uma das primeiras atividades.
Exemplos de documentação que favorece a exploração são o guia de início rápido do React, a folha de consulta de Flex de Yoksel e o Tour of Go. Este tipo de documentação tem qualidade lúdica e convida à exploração. É o terreno ideal para formatos inovadores que combinam a interação do utilizador com a documentação.
A documentação que promove a exploração é envolvente e divertida: a entrada perfeita para quem quer sentir como funciona um produto antes de aprofundar os seus conhecimentos. Juntamente com Avaliar e Compreender, Explorar situa-se no início do percurso pela documentação.
O que o utilizador quer fazer
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.
Sinais de que a documentação não responde a esta necessidade
- Os novos utilizadores não encontram um guia de início rápido ou um ambiente de testes onde possam experimentar o produto.
- A primeira experiência é uma parede de material de referência, não uma visita guiada.
- Os utilizadores têm de ler um manual inteiro antes de poderem utilizar o produto.
Dois exemplos reais
Tipos de conteúdo comuns
| DITA | Diátaxis | Good Docs Project |
|---|---|---|
| <task>, <step>, <substep> | Tutorial | Tutorial |
Uma métrica
tempo até ao primeiro valor · Tempo entre a primeira visita e a primeira interação bem-sucedida.