Guia por tema

Comunicação Técnica

Comunicação técnica que gera decisão: design docs e ADRs, apresentações para board e stakeholders, e narrativa para explicar estratégia técnica.

3 tópicos · 14 artigos

Comunicação escrita

Design docs, ADRs e documentos que alguém realmente lê.

Comunicação ao vivo

Reuniões, board e apresentações para stakeholders.

Narrativa técnica

Tornar estratégia e roadmap técnicos convincentes.

Perguntas frequentes

Qual o tamanho ideal de um design doc?

Entre 5 e 15 páginas: completo o bastante para decidir, curto o bastante para ser lido. Se passar disso, divida em documentos menores.

Quem deve revisar um design doc?

Quem será afetado pela decisão: arquitetos, líderes dos times envolvidos e produto. Revisores demais atrasam sem melhorar o documento.

Como apresentar para quem não é técnico?

Comece pelo impacto no negócio (custo, risco, prazo) e só depois explique a tecnologia, se perguntarem.

Quando escrever e quando apresentar?

Escreva propostas e decisões, que pedem leitura atenta. Apresente ao vivo problemas urgentes e assuntos que pedem conversa.