Documentação

Douglas Pereira

Escreve o caminho de quem está começando

• Instalar
• Um exemplo real
• O primeiro erro que a pessoa vai tomar

Referência não é tutorial

• Você precisa dos dois
• Tutorial tem enredo
• Referência tem forma para varrer com o olho

Perto do código

• Doc em outro prédio envelhece
• Exemplo quebrado é pior do que exemplo nenhum
• CI deveria pegar o snippet se der

Busca é feature

• Heading é para humano e para grep
• Usa as palavras que as pessoas digitam
• Se a resposta está no Slack, não está documentada