テーマ: 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 の指針は、行政文書以外にも適用できる。
-
文章で異議を述べる:立場を最も強い形で再構成し、中心的な論点を反駁する
決定を変えうる書面の異議は、相手の立場を最も強い形で述べ直し、争点を正確に示し、誤った箇所を引用し、根拠の種類と強さを明らかにし、代案を示す。Paul Graham の不同意の階層は、罵倒から中心的な論点の反駁まで、応答を順位付けしている。
-
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