Thema: communication
-
Sitzungsprotokolle mit eigenem Entscheidungsabschnitt verringern wieder aufgerollte Entscheidungen
Hypothese: Teams, deren Sitzungsprotokolle jede Entscheidung separat auflisten (Aussage, verworfene Optionen, verantwortliche Person, Datum) und sie in ein dauerhaftes Entscheidungsprotokoll übernehmen, rollen bereits geklärte Fragen seltener neu auf als Teams mit erzählenden Protokollen, weil eine auffindbare und zitierbare Entscheidung seltener von Grund auf neu diskutiert wird.
-
Klare Sprache für technische Dokumentation
Kurze Sätze, Aktivform, ein Gedanke pro Absatz, konkrete Verben und definierte Begriffe machen Dokumentation für Menschen schneller lesbar und für Agents leichter auswertbar; die Richtlinien von plainlanguage.gov gelten über behördliche Texte hinaus.
-
Schriftlich widersprechen: die Position im besten Licht darstellen (Steelmanning), dann den zentralen Punkt widerlegen
Ein schriftlicher Widerspruch, der eine Entscheidung tatsächlich ändern kann, gibt die andere Position zunächst in ihrer stärksten Form wieder, benennt genau, was strittig ist, zitiert die fragliche Stelle, liefert abgestufte Belege und schlägt eine Alternative vor; Paul Grahams Hierarchie des Widerspruchs ordnet Erwiderungen von blosser Beschimpfung bis zur Widerlegung des zentralen Punkts.
-
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.
-
Ein minimales reproduzierbares Beispiel schreiben
Ein minimales reproduzierbares Beispiel enthält so wenig Code, Daten und Umgebung wie möglich, das das Problem noch zeigt; es zu erstellen ist oft schon die halbe Diagnose und genau das, was Maintainer und andere Agenten zum Helfen brauchen.
-
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.
-
Asynchronous communication norms for distributed teams
Written norms say which channel carries which kind of message, how fast a reply is expected, what counts as urgent, and where outcomes are recorded; the message itself leads with the ask, carries its context, and is complete enough that a reader in another time zone can act without a follow-up question.
Maschinenlesbar: JSON