À propos des recommandations relatives aux contributions
Pour aider les contributeurs de votre projet à faire du bon travail, vous pouvez ajouter un fichier contenant des recommandations relatives aux contributions à la racine, au dossier docs
ou au dossier .github
du dépôt de votre projet. Quand une personne ouvre une demande de tirage ou crée un problème, elle voit un lien vers ce fichier.
Pour le propriétaire du dépôt, les recommandations relatives aux contributions sont un moyen de décrire la façon dont les utilisateurs doivent apporter leur contribution.
Pour les contributeurs, les recommandations sont un moyen de vérifier qu’ils envoient des demandes de tirage (pull request) bien formées, et qu’ils ouvrent des problèmes pertinents.
Pour les propriétaires comme pour les contributeurs, les recommandations relatives aux contributions permettent de gagner du temps et de réduire les tracas liés aux demandes de tirage mal créées, ou aux problèmes qui doivent être rejetés et soumis à nouveau.
Vous pouvez créer des instructions de contribution par défaut pour votre organisation ou votre compte personnel. Pour plus d’informations, consultez « Création d’un fichier d’intégrité de la communauté par défaut ».
Conseil : Les responsables de la gestion d’un dépôt peuvent définir des recommandations spécifiques aux problèmes en créant un modèle de problème ou de demande de tirage pour le dépôt. Pour plus d’informations, consultez « À propos des modèles de problème et de demande de tirage ».
Ajout d’un fichier CONTRIBUTING
-
Sur GitHub, accédez à la page principale du référentiel.
-
Au-dessus de la liste des fichiers, en utilisant la liste déroulante Ajouter un fichier, cliquez sur Créer un fichier.
-
Déterminez si vous souhaitez stocker vos recommandations relatives aux contributions à la racine, dans le répertoire
docs
ou dans le répertoire.github
de votre dépôt. Tapez ensuite dans le champ du nom de fichier, le nom et l’extension du fichier. Les noms de fichiers des recommandations relatives aux contributions ne respectent pas la casse. Les fichiers sont affichés au format RTF si l’extension de fichier est dans un format pris en charge. Pour plus d’informations, consultez « Travailler avec des fichiers non basés sur du code ».- Pour rendre vos recommandations relatives aux contributions visibles dans le répertoire racine du dépôt, tapez CONTRIBUTING.
- Pour rendre vos recommandations relatives aux contributions visibles dans le répertoire
docs
du dépôt, tapez docs/ pour créer le répertoire, puis CONTRIBUTING. - Si un dépôt contient plusieurs fichiers CONTRIBUTING, le fichier affiché dans les liens est choisi parmi les emplacements suivants dans cet ordre : répertoire
.github
, puis répertoire racine du dépôt et enfin répertoiredocs
.
-
Dans le nouveau fichier, ajoutez des recommandations relatives aux contributions. Vous pouvez inclure ce qui suit :
- Étapes permettant de créer des problèmes ou des demandes de tirage utiles.
- Liens vers de la documentation externe, des listes de diffusion ou un code de conduite.
- Attentes liées à la communauté et au comportement.
-
Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Création d’une validation avec plusieurs auteurs ».
-
Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « Création d’une demande de tirage ».
-
Cliquez sur Valider les modifications ou Proposer des modifications.
Exemples de recommandations relatives aux contributions
Si vous êtes perplexe, voici quelques bons exemples de recommandations relatives aux contributions :
- Recommandations relatives aux contributions pour GitHub Docs.
- Recommandations relatives aux contributions pour Ruby on Rails.
- Recommandations relatives aux contributions pour OpenGovernment.
Pour aller plus loin
- Section « Démarrage d’un projet open source » dans Open Source Guides
- « Ajout d’une licence à un dépôt »