Article original : How to Document Governing Procedures for Open-Source Communities
Dans les communautés open source, nous parlons souvent des directives de contribution, des codes de conduite et de l'intégration des nouveaux contributeurs. Mais une chose dont nous ne parlons pas assez ? La gouvernance.
La gouvernance semble sérieuse. Mais au fond, cela signifie simplement : comment prenons-nous les décisions et qui a le droit de les prendre ? Peu importe que vous travailliez sur un projet à la base avec quelques mainteneurs ou sur un écosystème open source mature, les procédures directrices influencent la manière dont les gens contribuent, gèrent les problèmes et deviennent des leaders.
Et, comme pour tout dans l'open source, si ce n'est pas documenté, cela peut aussi bien ne pas exister.
Dans cet article, je vais expliquer pourquoi la documentation de la gouvernance est importante, ce qu'il faut inclure et comment documenter les procédures de gouvernance qui sont utiles, claires et humaines.
Table des matières
Pourquoi la gouvernance est importante (et pourquoi vous devriez la documenter)
Rendre la documentation de gouvernance claire et accueillante
Comment commencer à documenter les procédures de gouvernance pour votre communauté open source
Pourquoi la gouvernance est importante (et pourquoi vous devriez la documenter)
Chaque communauté open source a déjà une forme de gouvernance (même si elle n'est pas écrite). Parfois, c'est un seul mainteneur qui prend toutes les décisions. Parfois, c'est un petit groupe de personnes qui "savent simplement ce qui est mieux". Le danger ici n'est pas la structure elle-même, mais le manque de clarté qui l'entoure.
Lorsque les procédures de gouvernance ne sont pas documentées :
Les nouveaux contributeurs peuvent être confus sur la manière de s'impliquer
Les décisions semblent arbitraires ou biaisées
Les dynamiques de pouvoir deviennent invisibles
Les conflits deviennent plus difficiles à gérer ou à résoudre équitablement
Documenter la gouvernance favorise la confiance, la transparence et la prévisibilité. Cela ne signifie pas confiner les contributeurs à des règles rigides, mais plutôt offrir à votre communauté une compréhension commune de la manière dont les choses fonctionnent et de la manière dont elles peuvent changer.
Ce que votre documentation de gouvernance devrait contenir
Vous n'avez pas besoin de commencer la documentation de gouvernance à partir de zéro. Vous avez probablement déjà des fragments de gouvernance dans votre README, CONTRIBUTING.md, ou dans les messages épinglés de votre plateforme de messagerie communautaire. L'objectif est de les rassembler en quelque chose de clair, navigable et convivial pour les contributeurs.
Considérez votre documentation de gouvernance comme une carte. Elle devrait aider les contributeurs à comprendre où ils se trouvent, comment les choses fonctionnent et quels chemins ils peuvent prendre, y compris :
Mission et valeurs : Pourquoi ce projet existe-t-il ? Quels principes guident la prise de décisions ou leur priorisation ? Cela peut donner le ton de la gouvernance et inviter à la collaboration.
Rôles et responsabilités : Qui sont les mainteneurs ? Que peuvent faire les contributeurs, les relecteurs et les membres de l'équipe principale ? Qui peut ouvrir des demandes de tirage ? Les réviser ? Approuver les propositions ? Définissez clairement les attentes et les limites.
Processus de prise de décision : Comment les décisions techniques sont-elles prises ? Par consensus ? Par vote ? Y a-t-il un mainteneur principal avec le dernier mot ? Quels types de décisions nécessitent l'avis de la communauté ? Comment les différends sont-ils résolus ?
Résolution des conflits : Que se passe-t-il si les gens ne sont pas d'accord ? Y a-t-il un processus pour escalader les problèmes de manière respectueuse ?
Processus de proposition : Comment les changements sont-ils proposés et discutés ? Utilisez-vous un système de RFC, des discussions GitHub ou autre chose ? Quel est le calendrier typique pour la révision ou les commentaires ?
Changements de leadership : Comment de nouveaux mainteneurs sont-ils ajoutés ? Comment quelqu'un peut-il se retirer ou être retiré ?
Modification de la gouvernance : Comment la procédure de gouvernance elle-même et sa documentation peuvent-elles être modifiées ? Qui a l'autorité de le faire ?
Directives de contribution : Comment les contributeurs peuvent-ils commencer ? Comment peuvent-ils soumettre une demande de tirage ? À quoi ressemble la révision et l'approbation ? Y a-t-il une échelle de contributeurs ? Que se passe-t-il après qu'une personne a contribué régulièrement ? Facilitez la navigation de l'expérience globale des contributeurs pour tout le monde.
Code de conduite (lié ou intégré) : La gouvernance et la conduite sont profondément liées. L'une façonne la culture, tandis que l'autre la protège.
Rendre la documentation de gouvernance claire et accueillante
La documentation de gouvernance n'a pas besoin d'être rédigée comme une politique juridique. En fait, elle ne devrait pas l'être. Un ton clair et accueillant aide les lecteurs à se sentir inclus, surtout les nouveaux venus ou les contributeurs issus de groupes sous-représentés.
Le ton que vous utilisez dans vos documents de gouvernance façonnera la manière dont les gens perçoivent votre communauté. Cela peut soit sembler une porte verrouillée, soit un chemin clair et amical vers l'avant. Voici comment les garder humains :
Utilisez un langage simple et clair. Évitez les termes trop complexes et expliquez les acronymes si nécessaire.
Soyez spécifique. "Vous devez être dans le serveur Discord pour voter" est mieux que "la participation est requise".
Gardez-le court et facile à lire. Utilisez des listes, des titres et des puces.
Expliquez le "pourquoi". Donnez plus de contexte. Les gens sont plus susceptibles de faire confiance aux règles lorsqu'ils comprennent pourquoi elles existent.
Utilisez des exemples ou des scénarios. Par exemple, "lorsque deux mainteneurs ne sont pas d'accord sur une direction technique..."
Rendez-le ouvert. Invitez les contributeurs à poser des questions ou à suggérer des changements, y compris aux procédures de gouvernance. Cela seul peut aider votre communauté à évoluer avec moins de friction.
Comment commencer à documenter les procédures de gouvernance pour votre communauté open source
J'ai aidé à documenter la gouvernance dans des projets où les choses avaient été informelles pendant des années. La partie la plus difficile ? Commencer. Il y a toujours une peur de dépasser les limites ou de "trop officialiser".
Mais écrire les choses ne signifie pas les graver dans le marbre. En fait, les meilleures documentations de gouvernance sont des documents vivants, créés avec la communauté, révisés régulièrement et mis à jour à mesure que le projet grandit.
Quelques leçons que j'ai apprises :
Commencez petit. Même une liste à puces dans un README est mieux que rien.
Utilisez les questions de votre communauté comme guide. Si les gens continuent de demander, "comment devenir mainteneur ?", écrivez-le.
Laissez les gens réviser et commenter. Co-créez, ne vous contentez pas d'imposer.
Si vous n'êtes pas sûr de par où commencer, regardez les projets open source qui ont bien fait cela. Par exemple, Kubernetes a un modèle de gouvernance bien structuré documenté dans son dépôt communautaire, détaillant tout, des rôles aux processus de prise de décision.
Le projet Tor maintient également une documentation de gouvernance transparente et pilotée par la communauté (un projet auquel j'ai eu l'opportunité de contribuer) qui définit les rôles, les responsabilités et les voies de prise de décision communiquées aux contributeurs du monde entier.
Conclusion
Documenter la gouvernance n'a pas besoin d'être effrayant. Il s'agit simplement de rendre l'invisible visible et de le faire de manière à inviter les gens. Lorsque vous écrivez comment les choses fonctionnent, vous faites de la place pour que les autres contribuent en toute confiance, comprennent la communauté à laquelle ils adhèrent et grandissent en son sein. C'est ce que la gouvernance devrait être.
Donc, si votre projet n'a pas encore ses principes de gouvernance documentés, n'attendez pas qu'il soit "assez grand". Commencez maintenant, commencez petit et laissez-le évoluer avec votre communauté.
Et rappelez-vous : la gouvernance n'est pas une question de contrôle. Il s'agit de clarté.