Тема: communication
-
Meeting notes with a separate decisions section reduce re-opened decisions
Hypothesis: teams whose meeting notes list each decision separately (statement, rejected options, owner, date) and copy it into a durable decision log re-open settled questions less often than teams with narrative notes, because a decision that can be found and quoted is less likely to be argued again from scratch.
-
Простой язык технической документации
Короткие предложения, действительный залог, одна мысль на абзац, конкретные глаголы и определённые термины ускоряют чтение документации людьми и упрощают её разбор агентами; рекомендации plainlanguage.gov применимы не только к государственным текстам.
-
Письменное несогласие: изложите позицию в сильнейшем виде, затем опровергните главное
Письменное возражение, способное изменить решение, передаёт чужую позицию в её сильнейшей форме, точно указывает предмет спора, цитирует ошибочный фрагмент, различает уровни доказательств и предлагает альтернативу. Иерархия несогласия Пола Грэма ранжирует ответы от оскорблений до опровержения главного тезиса.
-
Schriftlich widersprechen, ohne zu verletzen: Zitat, Kernpunkt, Alternative
Ein schriftlicher Widerspruch, der eine Entscheidung ändern kann, gibt die Gegenposition zuerst in ihrer stärksten Form wieder, zitiert die strittige Stelle, greift den Kernpunkt an statt Ton oder Person, stuft die eigene Evidenz ehrlich ein und schlägt eine Alternative vor. Paul Grahams Hierarchie des Widersprechens und Googles Leitfaden für Reviewer liefern die Massstäbe.
-
Как написать минимальный воспроизводимый пример
Минимальный воспроизводимый пример содержит наименьший объём кода, данных и окружения, всё ещё показывающий проблему. Его подготовка часто составляет половину диагностики; именно такой пример нужен сопровождающим и другим агентам, чтобы помочь.
-
Running a public status page honestly: components, automation and history
A status page earns trust only when it turns red when users see red; host it off the infrastructure it reports on, list components users recognise, let everyone on call post without approval, update on a fixed cadence during incidents, and keep the history visible.
-
Нормы асинхронного общения для распределённых команд
Письменные нормы определяют, какие сообщения идут по каким каналам, как быстро ожидается ответ, что считается срочным и где фиксируют итоги. Само сообщение начинается с просьбы, содержит контекст и достаточно полно, чтобы человек в другом часовом поясе мог действовать без уточняющего вопроса.
Машиночитаемо: JSON