Les contributions non code à l’open source
(github.com/readme)La contribution non code, clé du succès de l’open source
- Sarah Rainsberger, professeure de mathématiques, n’avait pas l’intention de devenir contributrice open source de son plein gré, mais elle a commencé à apprendre JavaScript et le développement web en reconstruisant le site web de sa chorale.
- En utilisant Astro, un framework frontend, elle a fini par contribuer au projet avec un petit morceau de code, un fichier de configuration, puis a pris un rôle de soutien aux nouveaux utilisateurs d’Astro en participant à la communauté.
- Rainsberger fait aujourd’hui partie du groupe central des mainteneurs d’Astro, mais elle intervient peu sur la base de code et se consacre surtout à la documentation, tout en aidant les autres à apprendre Astro.
Les tâches non code essentielles dans les projets open source
- Un projet open source a besoin, au-delà de l’écriture de code, de documentation, de localisation, de marketing, de design graphique, de tests, de gestion de communauté et de gestion des releases.
- L’importance des contributions non code est considérable : plus un projet est complexe, plus il a besoin de documentation, de tutoriels et de support pour rendre son code réellement utile.
- Le design graphique, le branding et l’outreach servent aussi de signaux sur la santé et le sérieux d’un projet, ce qui peut encourager d’autres projets ou entreprises à l’utiliser comme dépendance.
Pourquoi commencer par une contribution non code
- Les contributions non code offrent l’occasion de construire un portfolio pour les personnes intéressées par des rôles sans programmation, comme la communication technique, le design graphique ou le design de l’expérience utilisateur.
- Les programmeurs eux-mêmes y gagnent en affinant leurs compétences rédactionnelles et de communication, ce qui peut aussi les aider à évoluer vers des rôles comme les relations développeurs ou la gestion de produit.
- Les projets open source offrent des occasions de participation à tous les niveaux de compétence, et il est difficile d’apporter une contribution de code vraiment utile sans compréhension approfondie du projet.
Trouver des contributeurs non code et leur témoigner de la reconnaissance
- Pour les mainteneurs, le meilleur moyen de trouver des contributeurs est de demander des tâches précises ; il est aussi utile de bâtir une communauté et d’ouvrir des issues étiquetées "help wanted" et "good first issue".
- Le mentorat est l’un des meilleurs moyens d’amener les contributeurs vers la réussite, et valoriser puis reconnaître les contributeurs non code aide à motiver les contributeurs actuels et à en attirer de nouveaux.
L’avis de GN⁺
- Il est important de rappeler que le succès d’un projet open source repose sur bien plus que l’écriture de code. Ces différentes formes de contribution sont essentielles à sa pérennité et à sa croissance.
- Les contributions non code offrent aussi aux personnes non techniques une porte d’entrée vers l’open source, tout en pouvant les aider à développer des compétences techniques.
- Cet article peut inspirer celles et ceux qui s’intéressent à la communauté open source et les aider à trouver comment mettre leurs compétences au service de cette communauté.
6 commentaires
C’est un peu différent comme sujet, mais il y a quelque temps, quelqu’un a publié un tutoriel expliquant comment faire une PR sur le fichier README d’Express.js, ce qui a entraîné des centaines de PR sans aucune utilité.
Pull requests · expressjs/express
Une nuisance... snif
Il y a plus de 100 PR, quand même, wow
J’ai eu un petit moment de confusion sur la façon de contribuer avec du « barcode ».. haha
Une documentation très détaillée peut aussi être, d’une certaine manière, une arme à double tranchant.
Il peut y avoir des cas où la documentation et les captures d’écran deviennent si détaillées que les développeurs n’ont plus confiance dans leur capacité à les mettre à jour, et finissent par renoncer à développer des améliorations..
(« non ») du code)
Avis Hacker News
En tant qu’auteur/mainteneur de petites bibliothèques, je peux confirmer que sans contributions externes, les manuels ne seraient pas aussi bons qu’aujourd’hui. Les manuels contribuent fortement à l’utilisabilité d’un projet.
Souhaits pour les projets open source :
Dans l’open source, la documentation, les ressources, etc. sont importantes, mais cela peut aussi donner du pouvoir à des non-développeurs et finir par ruiner un projet.
Il est utile d’utiliser des plateformes de chat comme Discord, Gitter et Slack pour construire une communauté.
Sur la base d’une expérience dans la communauté WordPress, on pense que la documentation initiale et la solide documentation du Codex ont fortement contribué à la croissance de WordPress.
Le plus grand souhait pour un projet open source est que les gens l’utilisent et laissent une trace, sous une forme ou une autre, de ce qu’ils en ont fait.
Je ne sais pas si les contributions non liées au code sont le secret du succès d’un projet, mais je suis d’accord sur le fait qu’elles sont très importantes.
Lorsqu’on lance un projet open source, on peut s’attendre à ce qu’il y ait dix fois plus d’ingénieurs qui utiliseront le logiciel que d’ingénieurs qui écriront réellement du code.
Si des personnes non techniques comprennent le projet et y trouvent de la valeur, c’est un bon indicateur de réussite.
La documentation devient importante lorsqu’un produit passe d’un stade où il est utilisé par des fans malgré son manque de notoriété à un stade où il cherche à toucher davantage d’utilisateurs.