Verwalten und Lösen von Diskussionen

Die MDN-Community wird ermutigt, Diskussionen zu initiieren und daran teilzunehmen, die sich auf die MDN Web Docs-Dokumentation beziehen. Manche Diskussionen benötigen keine Lösung oder Übereinkunft, aber wenn doch, ist es natürlich, dass diejenigen, die die Diskussion beginnen, erwarten, dass ihre vorgeschlagenen Ideen zu einem logischen Abschluss kommen. Die meisten dieser Diskussionen erreichen schnell breite Übereinstimmung. Einige Diskussionen laufen jedoch Gefahr, ins Stocken zu geraten, weil ein klarer Weg zur Lösung fehlt, oft aufgrund unterschiedlicher Meinungen. Dieses Dokument bietet Richtlinien; es schlägt Prozesse und Strategien vor, die Ihnen helfen, innerhalb eines angemessenen Zeitraums eine Lösung zu erreichen, ohne dass das Gespräch ins Stocken gerät.

Eine Diskussion zu einer Lösung führen

Die meisten Diskussionen benötigen keinen formalen Lösungsprozess. Diese MDN-Diskussionsrichtlinien sind für Diskussionen gedacht, die eine rechtzeitige Lösung benötigen, ins Stocken geraten, Gefahr laufen, ins Stocken zu geraten, oder anderweitig nicht zu einem Abschluss führen und von einem formalen Prozess profitieren würden:

  1. Jede Diskussion wird in einer Diskussion auf GitHub abgehalten/verankert. Diese GitHub-Diskussion dient als "Quelle der Wahrheit" für das Thema.

    • Zur Aufrechterhaltung der Kontinuität sollten Sie Zusammenfassungen und Notizen aus allen Meetings und asynchronen Diskussionen in diesem GitHub-Diskussionsthread festhalten.

  2. Jedes Diskussionsthema benötigt einen Treiber. Der Treiber ist oft der Autor der Diskussion, kann aber auch eine andere Person sein, die sich der Lösung der Diskussion verpflichtet hat. Der Treiber ist verantwortlich für:

    • Die Gesprächsführung.
    • Die Bekanntmachung der Diskussion.
    • Festlegung und Mitteilung des Feedback-Zeitplans, Anpassung des Zeitplans nach Bedarf und Einhaltung des Zeitplans, soweit angemessen.
    • Informationen über alle geeigneten Kanäle - Slack, Discord, Personen auf GitHub kennzeichnen und andere Kanäle, falls geeignet - über benötigtes Feedback bis zu bestimmten Terminen informieren.
    • Das Thema in der Community und in wöchentlichen Meetings ansprechen.
    • Organisation eines synchronen, virtuellen Treffens, falls erforderlich (bei Meinungsverschiedenheiten). Face-to-face-Meetings sollten selten und nur bei Bedarf stattfinden (siehe Punkt 3).
    • Zusammenfassung der Ergebnisse von Face-to-face-Meetings in der relevanten Diskussion auf Discussions.
    • Die Implementierung der Diskussionsergebnisse zu leiten oder mit dem entsprechenden Teamleiter zusammenzuarbeiten, um sicherzustellen, dass die Ergebnisse umgesetzt werden.

  3. Face-to-face-Meetings zu einer Diskussion sollten nur bei Meinungsverschiedenheiten einberufen werden.

    • Face-to-face-Meetings müssen in allen relevanten Kommunikationskanälen angekündigt werden, wie Slack, Discord, GitHub-Diskussion, etc.
    • Die Ergebnisse jedes Face-to-face-Meetings müssen in die GitHub-Diskussion eingefügt werden, die die Quelle der Wahrheit für die Diskussion ist.
    • Der Treiber ist verantwortlich dafür, das Meeting einzuberufen, alle Parteien zu informieren und die Ergebnisse in die GitHub-Diskussion zu melden.

Sobald eine Übereinstimmung erreicht wurde, kann die Lösung verkündet, die Diskussion geschlossen und der Plan zur Umsetzung der Lösung in die Tat umgesetzt werden!

Fortschritt und Zeitrahmen der Diskussion

Jede Diskussion hat einen anderen Zeitrahmen, abhängig von der Komplexität des Themas und dem Einvernehmen. Idealerweise sollten die meisten Diskussionen innerhalb von zwei Monaten gelöst werden, damit das Thema in verschiedenen internen Meetings behandelt werden kann. Dieser Zeitrahmen gewährleistet, dass verschiedene Standpunkte berücksichtigt werden und alle Interessierten die Möglichkeit haben, an der Diskussion teilzunehmen.

  1. Die Diskussion veröffentlichen.
  2. Einen Treiber bestimmen. Den Treiber bestimmen, falls er nicht mit dem Diskussionsautor identisch ist.
  3. Alle wichtigen Stakeholder und benötigten Genehmiger identifizieren (die Personen, die zu dem Thema Stellung nehmen und ihre Zustimmung geben müssen), falls vorhanden.
  4. Die Genehmiger und andere wesentliche Stimmen über die Diskussion und Ihren vorgeschlagenen Zeitplan informieren. Bei Bedarf in 2-wöchigen Abständen und danach wöchentlich nachfassen, bis sie Feedback geben.
  5. Das Diskussionsthema auf die Tagesordnungen relevanter Meetings setzen.
  6. Nach einem Monat das Feedback, die Diskussionen und Vereinbarungen sichten und einen ersten Plan formulieren, der das Feedback in einen möglichen Aktionsplan integriert.
  7. Alle Interessierten erneut informieren und erneut um Feedback bitten, einschließlich aller Personen, die sich in irgendeiner Weise an der Diskussion beteiligt haben.
  8. Während des zweiten Monats weiterhin die Community nach Feedback zum vorgeschlagenen Plan fragen und den Plan in Anbetracht neuer Rückmeldungen aktualisieren. Wiederholen.
  9. Bei strittigen Punkten ein Online-Meeting arrangieren, um verbleibende Meinungsverschiedenheiten zu klären (wie im Diskussionsthread festgehalten).
  10. Die Diskussionsthreads im zweiten Monat am Leben erhalten, während Sie mit der Community auf eine Lösung hinarbeiten.
  11. Das Issue erstellen für den Lösungsumsetzungsplan und umsetzen. (Richtlinien zur Meldung von Issues)
  12. Die Diskussion schließen.

Wenn die Diskussion den Kontakt zu Experten und das Einholen von Feedback erfordert, kann der obige Zeitrahmen bei Bedarf verlängert werden.

Unschlüssige Lösungen

Es ist wichtig, zu einer Lösung zu kommen, aber es ist auch wichtig zu bedenken, dass nicht alle Diskussionen zu einer umsetzbaren Lösung führen. Das Ergebnis einer Diskussion kann "Es wird keine Entscheidung getroffen" oder "Wir sehen uns das in einem Jahr noch einmal an" lauten. Beides sind gültige Lösungen!

Wenn eine Diskussion ohne umsetzbare Lösung endet, vermerken Sie dies in der Diskussion und schließen Sie diese dann als gelöst.