Verwalten und Lösen von Diskussionen

Die MDN-Community wird ermutigt, Diskussionen über die MDN Web Docs Dokumentation zu initiieren und sich daran zu beteiligen. Einige Diskussionen bedürfen keiner Lösung oder Einigung, aber wenn doch, ist es natürlich, dass diejenigen, die die Diskussion starten, erwarten, dass ihre vorgeschlagenen Ideen zu einem logischen Abschluss kommen. Die meisten dieser Diskussionen erreichen schnell eine breite Einigung. Einige Diskussionen laufen jedoch Gefahr, ins Stocken zu geraten, aufgrund eines unklaren Wegs zur Lösung, oft wegen unterschiedlicher Meinungen. Dieses Dokument bietet Leitlinien und schlägt Prozesse und Strategien vor, die Ihnen helfen sollen, innerhalb eines angemessenen Zeitraums zu einer Lösung zu gelangen, ohne dass die Unterhaltung 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 die Diskussionen gedacht, die eine zeitnahe Lösung benötigen, ins Stocken geraten sind, Gefahr laufen, ins Stocken zu geraten, oder anderweitig nicht zu einer Schlussfolgerung kommen und von einem formalen Prozess profitieren würden:

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

    • Um die Kontinuität zu wahren, denken Sie daran, Zusammenfassungen und Notizen von Meetings und asynchronen Diskussionen in diesen GitHub-Diskussionsthread einzufügen.

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

    • Die Führung der Unterhaltung.
    • Das Bewusstsein für die Existenz der Diskussion schaffen.
    • Festlegen des Feedback-Zeitplans, die Beteiligten darüber informieren, den Zeitplan nach Bedarf ändern und den Zeitplan konsequent einhalten.
    • Alle relevanten Kanäle - Slack, Discord, Personen auf GitHub markieren und andere Kanäle, falls angemessen - über benötigtes Feedback zu bestimmten Terminen informieren.
    • Das Thema in Gemeinschafts- und wöchentlichen Meetings ansprechen.
    • Organisieren eines synchronen, online persönlichen Treffens, wenn erforderlich (bei Unstimmigkeiten). Persönliche Treffen sollten selten und nur bei Bedarf stattfinden (siehe Nr. 3).
    • Zusammenfassen der persönlichen Schlussfolgerungen in der entsprechenden Diskussion auf Discussions.
    • Die Umsetzung der Diskussionsresultate leiten oder mit dem entsprechenden Teamleiter sicherstellen, dass die Resultate umgesetzt werden.

  3. Persönliche Treffen bezüglich einer Diskussion sollten nur einberufen werden, wenn es Unstimmigkeiten gibt.

    • Persönliche Treffen müssen in allen relevanten Kommunikationskanälen angekündigt werden, wie Slack, Discord, GitHub-Diskussion, etc.
    • Die Schlussfolgerungen jedes persönlichen Treffens müssen in die GitHub-Diskussion eingetragen werden, die die Quelle der Wahrheit für die Diskussion ist.
    • Der Treiber ist verantwortlich für das Einberufen des Treffens, das Informieren aller Parteien und das Zurückbringen der Ergebnisse in die GitHub-Diskussion.

Sobald eine Einigung erzielt wurde, kann die Lösung bekannt gegeben, die Diskussion geschlossen und der Plan zur Umsetzung der Lösung in die Tat umgesetzt werden!

Fortschritt der Diskussion und Zeitplan

Jede Diskussion wird je nach Komplexität des Themas und Einigungsgrad einen anderen Zeitplan haben. Idealerweise sollten die meisten Diskussionen innerhalb von zwei Monaten gelöst werden, sodass das Thema bei verschiedenen internen Meetings angesprochen werden kann. Dieser Zeitrahmen stellt sicher, dass unterschiedliche Standpunkte berücksichtigt werden und alle Interessierten die Möglichkeit haben, zur Diskussion beizutragen.

  1. Stellen Sie die Diskussion ein.
  2. Weisen Sie einen Treiber zu. Bestimmen Sie den Treiber, wenn dieser nicht derselbe wie der Autor der Diskussion ist.
  3. Identifizieren Sie alle wichtigen Interessengruppen und benötigten Genehmiger (die Personen, die zu dem Thema Stellung nehmen und ihre Zustimmung geben müssen), falls vorhanden.
  4. Informieren Sie die Genehmiger und andere essenzielle Stimmen über die Diskussion und Ihren vorgeschlagenen Zeitplan. Falls erforderlich, kontaktieren Sie sie nach 2 Wochen erneut und danach wöchentlich, bis sie Feedback geben.
  5. Fügen Sie das Diskussionsthema den Agenden der relevanten Meetings hinzu.
  6. Sortieren Sie nach einem Monat das Feedback, die Diskussionen und Vereinbarungen und formulieren Sie einen ersten Plan, der das Feedback in einen möglichen Maßnahmenplan integriert.
  7. Informieren Sie alle interessierten Parteien erneut und fordern Sie erneut Feedback an, einschließlich aller Personen, die in irgendeiner Weise an der Diskussion teilgenommen haben.
  8. Bleiben Sie im zweiten Monat in Kontakt mit der Community, um Feedback zu dem vorgeschlagenen Plan einzuholen, und aktualisieren Sie den Plan in Anbetracht neuer Rückmeldungen. Wiederholen Sie den Vorgang.
  9. Falls es Streitpunkte gibt, organisieren Sie ein online, synchrones, persönliches Meeting, um verbleibende Unstimmigkeiten zu klären (wie im Diskussionsthread erfasst).
  10. Halten Sie die Diskussionsthreads während des zweiten Monats am Leben, während Sie mit der Community auf die Lösung hinarbeiten.
  11. Erstellen Sie das Issue für den Umsetzungsplan der Lösung und setzen Sie es in die Tat um. (Leitlinien zur Fehlerberichterstattung)
  12. Schließen Sie die Diskussion.

Falls die Diskussion das Erreichen und Empfangen von Feedback von Experten beinhaltet, kann der oben genannte Zeitplan nach Bedarf verlängert werden.

Unschlüssige Lösungen

Es ist wichtig, zu einer Lösung zu kommen, aber es ist auch wichtig, sich daran zu erinnern, dass nicht alle Diskussionen zu einer umsetzbaren Lösung führen werden. Eine Lösung einer Diskussion kann sein, dass "keine Entscheidung getroffen wird" oder "Lasst uns in einem Jahr darüber erneut sprechen". Dies sind beides gültige Lösungen!

Wenn eine Diskussion mit keiner umsetzbaren Lösung endet, vermerken Sie dies in der Diskussion und schließen Sie die Diskussion als gelöst.