Uma abordagem focada em decisões, não em tarefas

• Focar nas decisões

  • Uma citação de Every Page Is Page One trouxe uma grande mudança na abordagem de redação de documentação técnica
  • Na comunicação técnica, geralmente se fala em apoio à execução de tarefas, mas em muitos casos a informação de que as pessoas precisam para concluir uma tarefa não é como operar uma máquina, e sim informação para apoiar a tomada de decisões
  • Apenas documentar procedimentos não é suficiente
  • É preciso informar quais decisões o usuário deve tomar, quais são os resultados dessas decisões e direcioná-lo, sempre que possível, a recursos e materiais de referência que ajudem na tomada de decisão

Resumo do GN⁺

• Este texto enfatiza a importância do apoio à tomada de decisões na redação de documentação técnica
• É necessário ir além da simples descrição de procedimentos e ajudar o usuário a tomar decisões melhores
• Para quem escreve documentação técnica, é importante fornecer ao usuário o contexto e as informações de que ele precisa
• Como projetos do setor com funcionalidades semelhantes, Confluence e Notion são recomendados