Nouvelles directives de contribution

Si on te renvoie ici depuis une Issue/PR fermée automatiquement, ne panique pas et ne te sens pas rejeté. La plupart du temps, le travail que tu as fait finira par être fusionné dans Exercism, ou ton problème sera résolu. Nous accueillons et encourageons les contributions, mais nous préférons discuter des choses sur notre forum avant de nous plonger dans le code sur GitHub. Ouvrir un fil sur le forum fera avancer les choses.

Depuis un an, nous expérimentons la limitation des contributions des non-mainteneurs, afin de libérer du temps pour nos contributeurs principaux et de leur permettre d'apporter des améliorations plus importantes aux parcours. Cela a plutôt bien fonctionné. Par rapport à 2022, en 2023, nous avons vu deux fois plus de nouveaux exercices ajoutés et trois fois plus de programmes créés. Ce changement de méthodologie a permis des contributions bien plus importantes, moins de frustrations et moins de distractions pour nos contributeurs principaux.

Cependant, je suis aussi conscient que cela a créé des frustrations chez les nouveaux contributeurs qui souhaitent aider, mais qui se sentent bloqués par notre processus de contribution. Alors aujourd'hui, je veux proposer quelques nouvelles directives (ou des précisions) sur la façon dont nous allons gérer les contributions au cours des prochains mois.

La règle fondamentale à comprendre est la suivante : nous discutons des idées, des bugs et des problèmes sur notre forum, et nous discutons des modifications de code qui en résultent sur GitHub (lors des revues de PR). La règle secondaire est que (à l'exception des mainteneurs qui sont autonomes) nous discutons des choses avant de les faire. Notre forum permet aux contributeurs et aux mainteneurs de tous les parcours de partager connaissances et expérience sur un large éventail de langages et d'idées, sans avoir à s'abonner à 300 dépôts différents sur GitHub et à submerger leurs notifications.

Directives mises à jour

Obtiens de l'aide

• Si tu es bloqué sur quelque chose avant de résoudre un exercice (par exemple installer la CLI, lancer les tests, ou bloqué sur la logique/les exigences d'un exercice), nos mécanismes d'assistance sont la catégorie « Exercism Support » sur le forum et le canal #get-help sur notre serveur Discord.
• Nous n'utilisons pas GitHub ni l'e-mail pour les demandes d'assistance.
• Si tu as résolu un exercice mais que tu as des questions à son sujet, tu devrais demander du mentorat directement sur Exercism.

Signale des bugs/problèmes

• Tous les bugs et problèmes doivent être signalés sur notre forum, où un large éventail de personnes peut aider à comprendre et à résoudre le problème.
  • Si le problème concerne un langage, utilise la catégorie Programming/xxx correspondante.
  • S'il s'agit d'un bug sur le site web, utilise la catégorie « Bugs & Feature Requests ».
• Les issues GitHub seront généralement fermées automatiquement, et leur auteur sera redirigé vers le forum (avec un lien en un clic pour copier/coller son issue, comme c'est le cas actuellement).
• Les mainteneurs d'un parcours peuvent choisir de désactiver la fermeture automatique des issues, mais la voie officielle reste le forum.

Ouvre des Pull Requests

• Les Pull Requests doivent être discutées sur le forum avant que le travail ne soit fait.
• Les Pull Requests provenant de personnes extérieures à l'organisation continueront d'être fermées automatiquement, mais seront souvent réouvertes une fois le travail discuté sur le forum. Si l'idée derrière une PR a déjà été approuvée, ajoute simplement un lien vers la PR sur le fil correspondant du forum et nous la réouvrirons.
• Les mainteneurs d'un parcours peuvent choisir de désactiver la fermeture automatique des PR, mais nous recommandons toujours que toutes les PR soient d'abord discutées sur le forum.

Résumé

Notre priorité absolue reste de protéger le temps et la capacité mentale de nos contributeurs principaux, sans qui Exercism ne peut pas fonctionner. Mais nous voulons aussi nous assurer qu'Exercism reste un endroit où de nouvelles personnes peuvent s'impliquer sans barrières trop prohibitives, et où nous pouvons encourager et soutenir ces personnes pour qu'elles deviennent elles-mêmes des contributeurs principaux !

Je suis impatient de voir comment ces changements affecteront les contributions que nous verrons au cours des prochains mois. Nous ferons le point à nouveau à la mi-2024.