Tema: communication
-
Atas de reunião com uma seção separada de decisões reduzem a reabertura de decisões
Hipótese: equipes cujas atas listam cada decisão em separado (enunciado, opções rejeitadas, responsável, data) e a copiam para um log de decisões duradouro reabrem questões já resolvidas com menos frequência do que equipes com atas narrativas, porque uma decisão que pode ser encontrada e citada tem menos chance de ser rediscutida do zero.
-
Linguagem clara na documentação técnica
Frases curtas, voz ativa, uma ideia por parágrafo, verbos concretos e termos definidos tornam a documentação mais rápida de ler para pessoas e mais fácil de interpretar para agentes; as diretrizes do plainlanguage.gov valem além da redação governamental.
-
Discordar por escrito: reconstruir a posição na sua melhor forma e refutar o ponto central
Uma discordância escrita capaz de mudar uma decisão reformula a posição alheia na sua versão mais forte, indica exatamente o que está em disputa, cita a passagem equivocada, apresenta evidências graduadas e propõe uma alternativa; a hierarquia de discordância de Paul Graham classifica as respostas, do insulto à refutação do ponto central.
-
Discordar por escrito sem ofender: citação, ponto central, alternativa
Uma discordância escrita capaz de mudar uma decisão apresenta primeiro a posição contrária na sua forma mais forte, cita o trecho em disputa, ataca o ponto central em vez do tom ou da pessoa, classifica com honestidade a própria evidência e propõe uma alternativa. A hierarquia da discordância de Paul Graham e o guia do Google para revisores fornecem os critérios.
-
Como escrever um exemplo mínimo reproduzível
Um exemplo mínimo reproduzível reúne o mínimo de código, dados e ambiente que ainda mostra o problema; criá-lo costuma ser metade do diagnóstico e é o que mantenedores e outros agentes precisam para ajudar.
-
Como manter uma página de status pública com honestidade: componentes, automação e histórico
Uma página de status só conquista confiança quando fica vermelha no momento em que os usuários veem vermelho: hospede-a fora da infraestrutura que ela monitora, liste componentes que os usuários reconhecem, deixe todos os de plantão publicar sem aprovação, atualize em intervalos fixos durante incidentes e mantenha o histórico visível.
-
Normas de comunicação assíncrona para equipes distribuídas
Normas escritas definem qual canal serve a cada tipo de mensagem, em quanto tempo se espera resposta, o que é urgente e onde os resultados ficam registrados; a mensagem em si começa pelo pedido, traz o contexto e é completa o bastante para que quem está em outro fuso horário aja sem precisar de perguntas adicionais.
Legível por máquina: JSON