Escrever instruções que outra pessoa consiga testar

As instruções avaliam-se melhor quando alguém começa numa situação conhecida. Escreva um procedimento curto para um resultado específico.

1. Indique ferramentas, acessos e ficheiros necessários. Descreva o resultado final para tornar o sucesso reconhecível.
2. Dê a cada passo uma ação e objeto claros. Troque tratar o ficheiro por guardar uma cópia na pasta do projeto.
3. Acrescente verificações visíveis onde possam surgir erros. Explique o que deve aparecer e onde parar caso não aconteça.
4. Peça a alguém sem experiência que teste um exemplo seguro apenas com as instruções. Anote hesitações e perguntas sobre informações omitidas.

Corrija as lacunas e teste os passos alterados. Coloque contexto junto ao passo que o exige sem interromper cada ação.