Classification de votre dépôt avec des rubriques

Pour aider d’autres personnes à trouver votre projet et à y contribuer, vous pouvez ajouter des rubriques à votre dépôt en lien avec la finalité, le domaine, les groupes d’affinités ou d’autres qualités importantes de votre projet.

Dans cet article

À propos des rubriques

Avec les rubriques, vous pouvez explorer les dépôts dans un domaine particulier, rechercher des projets auxquels contribuer, et découvrir de nouvelles solutions à un problème spécifique. Les rubriques s’affichent sur la page principale d’un dépôt. Vous pouvez cliquer sur un nom de rubrique pour voir les rubriques connexes et une liste d’autres dépôts classifiés avec cette rubrique.

Capture d’écran du dépôt github/docs. Dans la barre latérale à droite, trois rubriques sont indiquées en orange foncé : « docs », « hacktoberfest » et « works-with-codespaces ».

Pour parcourir les sujets les plus utilisés, allez à github.com/topics/.

Vous pouvez contribuer à l’ensemble de rubriques suggérées de GitHubdans le dépôt github/explore.

Les administrateurs de dépôt peuvent ajouter toutes les rubriques qu’ils souhaitent à un dépôt. Les rubriques utiles pour classifier un dépôt incluent l’objectif prévu, le domaine, la communauté ou le langage du dépôt. En outre, GitHub analyse le contenu des dépôts publics et génère des rubriques suggérées que les administrateurs de dépôt peuvent accepter ou rejeter. Le contenu des dépôts privés n’est pas analysé et ne reçoit pas de suggestions de rubriques.

Les dépôts publics et privés peuvent avoir des rubriques, mais vous verrez uniquement les dépôts privés auxquels vous avez accès dans les résultats de recherche de rubriques.

Vous pouvez rechercher des dépôts associés à une rubrique particulière. Pour plus d’informations, consultez « Recherche de référentiels ». Vous pouvez également rechercher une liste de rubriques sur GitHub. Pour plus d’informations, consultez « Recherche de rubriques ».

Lors de la création d’une rubrique

  • Utilisez des lettres minuscules, chiffres et traits d’union.
  • Utilisez 50 caractères au maximum.
  • N’ajoutez pas plus de 20 rubriques.

Ajout de rubriques à votre dépôt

Remarque : Les noms de rubriques sont toujours publics, même si vous créez la rubrique à partir d’un dépôt privé.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Dans le coin supérieur droit de la page, à droite de « À propos de », cliquez sur .

    Capture d’écran du coin supérieur droit de la page principale d’un dépôt. Le bouton « Modifier les métadonnées du dépôt », représenté par une icône d’engrenage, est encadré en orange.

  3. Sous « Rubriques », commencez à taper la rubrique que vous souhaitez ajouter à votre dépôt pour afficher un menu déroulant de toutes les rubriques correspondantes. Cliquez sur la rubrique que vous souhaitez ajouter ou continuez à taper pour créer une rubrique.

    Capture d’écran du champ « Rubriques » montrant des exemples de rubrique : « docs » et « works-with-codespaces ». Une rubrique « Suggérée » « documentation » est illustrée ci-dessous.

  4. Facultatif, si des rubriques « Suggérées » sont affichées sous le champ « Rubriques », cliquez sur pour ajouter ou pour refuser la rubrique suggérée.

  5. Une fois que vous avez terminé d’ajouter des rubriques, cliquez sur Enregistrer les modifications.