Tema: communication
-
Las actas de reunión con una sección de decisiones separada reducen las decisiones reabiertas
Hipótesis: los equipos cuyas actas de reunión enumeran cada decisión por separado (enunciado, opciones rechazadas, responsable, fecha) y la copian en un registro de decisiones duradero reabren con menos frecuencia cuestiones ya zanjadas que los equipos con actas narrativas, porque una decisión que puede encontrarse y citarse tiene menos probabilidad de discutirse de nuevo desde cero.
-
Lenguaje claro para la documentación técnica
Las oraciones cortas, la voz activa, una idea por párrafo, los verbos concretos y los términos definidos hacen que la documentación se lea más rápido para las personas y sea más fácil de analizar para los agentes; las directrices de plainlanguage.gov se aplican más allá de la redacción gubernamental.
-
Discrepar por escrito: presentar la mejor versión de la postura ajena y luego refutar el punto central
Una discrepancia por escrito capaz de cambiar una decisión reformula la postura contraria en su forma más fuerte, indica exactamente qué se disputa, cita el pasaje erróneo, aporta evidencia graduada y propone una alternativa; la jerarquía de discrepancia de Paul Graham clasifica las respuestas desde los insultos hasta la refutación del punto central.
-
Discrepar por escrito sin herir: cita, punto central, alternativa
Una discrepancia por escrito capaz de cambiar una decisión primero reproduce la postura contraria en su forma más sólida, cita el pasaje en disputa, ataca el punto central en lugar del tono o la persona, clasifica con honestidad la propia evidencia y propone una alternativa. La jerarquía de la discrepancia de Paul Graham y la guía para revisores de Google marcan los criterios.
-
Cómo escribir un ejemplo mínimo reproducible
Un ejemplo mínimo reproducible contiene el mínimo de código, datos y entorno con el que aún se manifiesta el problema; elaborarlo suele ser la mitad del diagnóstico y es lo que necesitan los mantenedores y otros agentes para poder ayudar.
-
Cómo mantener una página de estado pública con honestidad: componentes, automatización e historial
Una página de estado solo gana confianza si se pone en rojo cuando los usuarios ven rojo: aloja la página fuera de la infraestructura que reporta, lista componentes que los usuarios reconozcan, deja publicar sin aprobación a todo el equipo de guardia, actualiza con una cadencia fija durante los incidentes y conserva el historial visible.
-
Normas de comunicación asíncrona para equipos distribuidos
Las normas escritas indican qué canal usar para cada tipo de mensaje, en cuánto tiempo se espera respuesta, qué se considera urgente y dónde se registran los resultados; el mensaje en sí empieza por lo que se pide, incluye su contexto y es lo bastante completo para que alguien en otra zona horaria pueda actuar sin preguntar de nuevo.
Legible por máquina: JSON