Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

Création d’un fichier d’intégrité de la communauté par défaut

Vous pouvez créer des fichiers d’intégrité par défaut pour la communauté, comme CONTRIBUTING et CODE_OF_CONDUCT. Les fichiers par défaut seront utilisés pour tout dépôt appartenant à votre organisation qui ne contient pas son propre fichier d’intégrité.

À propos des fichiers d’intégrité de la communauté par défaut

Vous pouvez ajouter des fichiers d’intégrité de la communauté par défaut à un dépôt public appelé .github, à la racine du dépôt ou dans les dossiers docs ou .github.

GitHub utilise et affiche les fichiers par défaut pour tout dépôt appartenant au compte qui n’a pas son propre fichier de ce type à l’un des emplacements suivants :

  • racine du dépôt
  • dossier .github
  • dossier docs

Par exemple, toute personne qui crée un problème ou une demande de tirage dans un dépôt qui n’a pas son propre fichier CONTRIBUTING voit un lien vers le fichier CONTRIBUTING par défaut. Si un dépôt a des fichiers dans son propre dossier .github/ISSUE_TEMPLATE, notamment des modèles de problème ou un fichier config.yml, aucun des contenus du dossier .github/ISSUE_TEMPLATE par défaut n’est utilisé.

Les fichiers par défaut ne sont pas inclus dans les clones, les packages ou les téléchargements de dépôts individuels, car ils sont stockés uniquement dans le dépôt .github.

Types de fichiers pris en charge

Vous pouvez créer des valeurs par défaut dans votre organisation ou votre compte personnel pour les fichiers d’intégrité de la communauté suivants :

Fichier d’intégrité de la communauté | Description --- | --- CODE_OF_CONDUCT.md | Un fichier CODE_OF_CONDUCT définit les standards d’engagement dans une communauté. Pour plus d’informations, consultez « Ajouter un code de conduite à votre projet ». CONTRIBUTING.md | Un fichier CONTRIBUTING indique la façon dont les gens doivent contribuer à votre projet. Pour plus d’informations, consultez « Définition de recommandations pour les contributeurs de dépôt ». Formulaires de catégorie de discussion | Les formulaires de catégorie de discussion personnalisent les modèles qui sont disponibles pour les membres de la communauté lorsque ces derniers ouvrent de nouvelles discussions dans votre dépôt. Pour plus d’informations, consultez « Créer des formulaires de catégorie de discussion ». FUNDING.yml | Un fichier FUNDING affiche un bouton de sponsor dans votre dépôt pour augmenter la visibilité des options de financement de votre projet open source. Pour plus d’informations, consultez « Affichage d’un bouton Sponsor dans votre dépôt ». GOVERNANCE.md | Un fichier GOVERNANCE permet aux utilisateurs de savoir comment votre projet est gouverné. Par exemple, il peut parler des rôles du projet et de la façon dont les décisions sont prises. Modèles de problème et de demande de tirage et config.yml | Les modèles de problème et de demande de tirage personnalisent et standardisent les informations que vous souhaitez que les contributeurs incluent quand ils ouvrent des problèmes et des demandes de tirage dans votre dépôt. Pour plus d’informations, consultez « À propos des modèles de problème et de demande de tirage ». SECURITY.md | Un fichier SECURITY fournit des instructions sur la façon de signaler une faille de sécurité dans votre projet. Pour plus d’informations, consultez « Ajout d’une stratégie de sécurité à votre dépôt ». SUPPORT.md | Un fichier SUPPORT permet aux utilisateurs de connaître les moyens d’obtenir de l’aide pour votre projet. Pour plus d’informations, consultez « Ajout de ressources de support à votre projet ».

Vous ne pouvez pas créer de fichier de licence par défaut. Vous devez ajouter les fichiers de licence à des dépôts individuels pour qu’ils soient inclus quand un projet est cloné, packagé ou téléchargé.

Création d’un dépôt pour les fichiers par défaut

  1. En haut à droite d’une page, utilisez le menu déroulant et sélectionnez Nouveau dépôt.

    Capture d’écran d’un menu déroulant GitHub montrant les options permettant de créer des éléments. L’élément de menu « Nouveau référentiel » est souligné en orange foncé.

  2. Utilisez le menu déroulant Propriétaire, puis sélectionnez l’organisation ou le compte personnel pour lequel vous souhaitez créer les fichiers par défaut. Capture d’écran du menu propriétaire d’un nouveau dépôt GitHub. Le menu montre deux options, octocat et github.

  3. Dans le champ « Nom du dépôt », tapez .github.

  4. Dans le champ « Description », vous pouvez taper une description.

  5. Vérifiez que l’état du dépôt est défini sur Public. Un dépôt pour les fichiers par défaut ne peut pas être privé.

  6. Sélectionnez Initialize this repository with a README (Initialiser ce dépôt à l’aide d’un fichier LISEZMOI). 1. Cliquez sur Créer le dépôt.

  7. Dans le dépôt, créez l’un des fichiers d’intégrité de la communauté pris en charge. Les modèles de problème et leur fichier config doivent se trouver dans un dossier appelé .github/ISSUE_TEMPLATE. Tous les autres fichiers pris en charge peuvent se trouver à la racine du dépôt, dans le dossier .github ou dans le dossier docs. Pour plus d’informations, consultez « Création de fichiers ».