Gestion et résolution des discussions
La communauté MDN est encouragée à initier et à participer à des discussions autour de la documentation du MDN Web Docs. Certaines discussions n'ont pas besoin de résolution ou d'accord, mais si c'est le cas, il est naturel que ceux qui lancent la discussion s'attendent à ce que leurs idées proposées atteignent une conclusion logique. La plupart de ces discussions parviennent rapidement à un large consensus. Cependant, certaines discussions risquent de devenir bloquées en raison d'un chemin peu clair vers une résolution, souvent en raison d'opinions divergentes. Ce document propose des directives ; suggérant des processus et des stratégies pour vous aider à progresser vers une résolution dans un délai raisonnable sans que la conversation ne soit bloquée.
Faire avancer une discussion vers une résolution
La plupart des discussions n'ont pas besoin d'un processus de résolution formel. Ces directives de discussion MDN sont là pour les discussions qui ont besoin d'une résolution rapide, qui sont bloquées, qui risquent de devenir bloquées ou qui ne progressent pas vers une conclusion et qui bénéficieraient d'un processus formel :
-
Chaque discussion est ancrée dans une discussion sur GitHub (angl.). Cette discussion GitHub sert de « source de vérité » pour le sujet.
- Pour maintenir la continuité, n'oubliez pas de capturer les résumés et les notes de toutes les réunions et discussions asynchrones dans ce fil de discussion GitHub.
-
Chaque sujet de discussion a besoin d'un responsable. Le responsable est souvent l'auteur de la discussion, mais peut être une autre personne engagée à résoudre la discussion. Le responsable est responsable de :
- Guider la conversation.
- Faire en sorte que les gens soient au courant de l'existence de la discussion.
- Définir les retours, le calendrier, en informer les gens, modifier le calendrier si nécessaire et s'y tenir de manière appropriée.
- Informer tous les canaux appropriés - Slack, Discord, taguer des personnes sur GitHub et d'autres canaux si nécessaire - des retours nécessaires avant des dates spécifiques.
- Aborder le sujet lors des réunions communautaires et hebdomadaires.
- Organiser une réunion en face à face en ligne synchrone si nécessaire (s'il y a désaccord). Les réunions en face à face doivent être rares et uniquement si nécessaire (voir #3).
- Résumer les conclusions des réunions en face à face dans la discussion pertinente sur Discussions (angl.).
- Guider la mise en œuvre des résultats de la discussion ou travailler avec le responsable d'équipe approprié pour s'assurer que les résultats sont mis en œuvre.
-
Les réunions en face à face concernant une discussion ne doivent être convoquées que s'il y a désaccord.
- Les réunions en face à face doivent être annoncées dans tous les canaux de communication pertinents, tels que Slack, Discord, discussion GitHub, etc.
- Les conclusions de chaque réunion en face à face doivent être saisies dans la discussion GitHub, qui est la source de vérité pour la discussion.
- Le responsable est responsable de la convocation de la réunion, d'informer toutes les parties et de faire rapport des résultats dans la discussion GitHub.
Une fois qu'un accord a été atteint, la résolution peut être annoncée, la discussion peut être clôturée et le plan de mise en œuvre de la résolution peut être mis en action !
Progression et calendrier des discussions
Chaque discussion aura un calendrier différent en fonction de la complexité du sujet et des niveaux de consensus. Idéalement, la plupart des discussions devraient être résolues dans un délai de deux mois, permettant ainsi d'aborder le sujet lors de diverses réunions internes. Ce délai garantit que des points de vue divers sont pris en compte et que toutes les personnes intéressées ont la possibilité de contribuer à la discussion.
- Publiez la discussion.
- Assignez un responsable. Déterminez le responsable s'il n'est pas le même que l'auteur de la discussion.
- Identifiez les parties prenantes clés et les parties prenantes nécessaires (les personnes qui doivent peser sur le sujet et donner leur approbation), le cas échéant.
- Informez les parties prenantes et d'autres voix essentielles de la discussion et de votre calendrier proposé. Si nécessaire, contactez-les à nouveau après 2 semaines, puis chaque semaine par la suite, jusqu'à ce qu'ils fournissent des commentaires.
- Ajoutez le sujet de la discussion aux ordres du jour des réunions pertinentes.
- Après un mois, triez les commentaires, les discussions et les accords, et formulez un plan initial fusionnant les commentaires dans un plan d'action possible.
- Ré-informez et redemandez des commentaires à toutes les parties intéressées, y compris tous ceux qui ont participé à la discussion de quelque manière que ce soit.
- Au cours du deuxième mois, continuez à solliciter la communauté pour obtenir des commentaires sur le plan proposé, en apportant des mises à jour au plan à la lumière de tout nouveau retour. Rincez. Répétez.
- S'il y a des points de désaccord, organisez une réunion en ligne, synchrone et en face à face pour résoudre tout désaccord restant (tel que capturé dans le fil de discussion).
- Gardez les fils de discussion actifs pendant le deuxième mois alors que vous travaillez avec la communauté vers la résolution.
- Créez le problème (Issue) pour le plan de mise en œuvre de la résolution et mettez-le en action. (Directives de signalement des problèmes)
- Fermez la discussion.
Si la discussion implique de contacter et de recevoir des commentaires d'experts, le calendrier ci-dessus peut être prolongé si nécessaire.
Résolutions non concluantes
Il est important d'arriver à une résolution, mais il est également important de se rappeler que toutes les discussions ne parviendront pas à une résolution pouvant être mise en œuvre. La résolution d'une discussion peut être « aucune décision n'est prise » ou « revisitons cela dans un an ». Ce sont toutes deux des résolutions valides !
Lorsqu'une discussion se termine sans résolution pouvant être mise en œuvre, notez-le dans la discussion, puis fermez la discussion en tant que résolue.