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é.

Dans cet article

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

Les fichiers d’intégrité de la communauté par défaut sont un ensemble de fichiers prédéfinis qui fournissent des conseils et des modèles permettant de maintenir un projet open source sain et collaboratif. Ces fichiers vous aident à automatiser et à standardiser divers aspects du développement de votre projet et de l’interaction avec la communauté, favorisant ainsi la transparence, les bonnes pratiques et la collaboration.

Vous pouvez ajouter des fichiers d’intégrité de la communauté par défaut à un référentiel public appelé .github et GitHub Enterprise Server utilisera et affichera les fichiers par défaut pour tout référentiel appartenant au compte qui n’a pas son propre fichier de ce type dans l’ordre suivant :

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

Si aucun fichier correspondant n’est trouvé dans le référentiel actuel, GitHub Enterprise Server utilisera le fichier par défaut du référentiel .github, en suivant le même ordre de priorité.

Par exemple, toute personne qui crée un problème ou une demande de tirage dans un référentiel qui n’a pas son propre fichier CONTRIBUTING.md verra un lien vers le CONTRIBUTING.md par défaut du référentiel .github. Toutefois, si un référentiel possède des fichiers dans son propre dossier .github/ISSUE_TEMPLATE, tels que des modèles de questions ou un fichier _config.yml, aucun contenu du dossier .github/ISSUE_TEMPLATE par défaut ne sera utilisé. Cela permet aux responsables des référentiels de remplacer les fichiers par défaut par des modèles ou des contenus spécifiques pour chaque référentiel.

Le stockage des fichiers dans le référentiel .github permet d’apporter des modifications aux fichiers par défaut en un seul endroit. De plus, ils n’apparaîtront pas dans le navigateur de fichiers ou l’historique Git des référentiels individuels, et ne sont pas inclus dans leurs clones, packages ou téléchargements.

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
CONTRIBUTING.mdUn fichier CONTRIBUTING communique la façon dont les personnes 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 discussionLes formulaires de catégorie de discussion personnalisent les modèles disponibles pour les membres de la communauté à utiliser lorsqu’ils ouvrent de nouvelles discussions dans votre dépôt. Pour plus d’informations, consultez « Créer des formulaires de catégorie de discussion ».
GOVERNANCE.mdUn fichier GOVERNANCE permet aux utilisateurs de savoir comment votre projet est régi. 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.ymlLes modèles de demande de tirage et de problème personnalisent et normalisent les informations que vous souhaitez inclure quand ils ouvrent des problèmes et des demandes de tirage dans votre référentiel. Pour plus d’informations, consultez « À propos des modèles de problème et de demande de tirage ».
SECURITY.mdUn fichier SECURITY fournit des instructions pour signaler une faille de sécurité dans votre projet et une description qui crée un lien hypertexte vers le fichier. Pour plus d’informations, consultez « Ajout d’une stratégie de sécurité à votre dépôt ».
SUPPORT.mdUn fichier SUPPORT permet aux utilisateurs de savoir comment obtenir de l’aide sur 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. Dans le coin supérieur droit de n’importe quelle page, sélectionnez sur , puis cliquez sur Nouveau référentiel.

    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).

  7. Cliquez sur Créer le dépôt.

  8. 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 ».