Skip to main content

Soumission de votre dépôt à GitHub Community Exchange

Vous pouvez soumettre votre dépôt à GitHub Community Exchange pour que d’autres utilisateurs puissent le voir ou y contribuer.

À propos des soumissions de dépôts

Seuls les dépôts publics appartenant à des comptes personnels peuvent être soumis à GitHub Community Exchange.

Il existe trois types de soumissions de dépôts :

  • Learn. Dépôt permettant de partager des instructions pas à pas pour créer un projet.
  • Collaborate. Dépôt recherchant des collaborateurs pour travailler sur un projet.
  • Learn et Collaborate. Dépôt qui est une combinaison de Learn et de Collaborate.

Réfléchissez à l’objectif principal de votre dépôt lorsque vous choisissez le type de soumission pour votre dépôt.

Pour promouvoir votre projet et le rendre plus découvrable auprès des autres étudiants, vous devez attribuer un ou plusieurs thèmes et offres GitHub Student Developer Pack à votre dépôt. Pour plus d’informations, consultez « Classification de votre dépôt avec des rubriques ».

Une fois qu’un dépôt a été soumis à GitHub Community Exchange, il sera immédiatement publié avec l’objectif, les thèmes et les offres que vous avez choisis. La communauté GitHub Community Exchange modère toutes les soumissions de dépôt.

Conditions de soumission

Votre dépôt doit respecter un minimum de conditions pour qu’une soumission soit acceptée. Pendant le processus de soumission, si les critères de soumission n’ont pas été respectés pour le dépôt sélectionné, vous êtes notifié des éléments manquants.

Pour une soumission dont l’objectif est Learn, votre dépôt doit avoir :

  • Une description.
  • Un fichier LEARN.md pour fournir des instructions pas à pas, avec du texte et/ou des supports, sur la façon dont vous avez créé votre projet. Dans l’idéal, votre fichier LEARN.md divise votre projet en petits composants et fournit des détails approfondis sur chaque étape, afin que d’autres étudiants puissent coder leur projet en suivant vos instructions.
  • Un fichier README.md pour fournir une description détaillée de votre projet.
  • Une licence, pour que d’autres utilisateurs sachent ce qu’ils peuvent ou ne peuvent pas faire avec votre code source.

Pour une soumission dont l’objectif est Collaborate, votre dépôt doit avoir :

  • Une description.
  • Un fichier README.md pour fournir une description détaillée de votre projet.
  • Une licence, pour que d’autres utilisateurs sachent ce qu’ils peuvent ou ne peuvent pas faire avec votre code source.
  • Un ou plusieurs problèmes pour que les collaborateurs travaillent dessus.
  • Fichier CONTRIBUTING.md pour communiquer comment contribuer à votre projet.

Une bonne soumission de dépôt pour les deux objectifs Learn et Collaborate est un dépôt qui suit les standards de la communauté. Pour plus d’informations, consultez « À propos des profils de communauté des dépôts publics ».

Soumission de votre dépôt

  1. Depuis votre tableau de bord GitHub Education, accédez à la page d’accueil de GitHub Community Exchange.
  2. Au-dessus de la liste des dépôts, à droite de la zone de recherche et des filtres déroulants, cliquez sur Ajouter un dépôt.
    Capture d’écran d’une ligne de boutons et de menus déroulants. Le bouton « Ajouter un dépôt » est encadré en orange foncé.
  3. Dans la fenêtre contextuelle, utilisez le menu déroulant Quel est le but de votre soumission ? et sélectionnez une ou plusieurs entrées correspondant à votre soumission.
  4. Utilisez le menu déroulant Quel dépôt aimeriez-vous utiliser ? et sélectionnez le dépôt à soumettre. Si les critères de soumission n’ont pas été remplis, vous êtes informé des éléments manquants et vous pouvez cliquer sur Modifier votre dépôt si vous souhaitez afficher le dépôt et apporter des modifications pour répondre aux critères.
  5. Utilisez le menu déroulant Quelles offres avez-vous utilisées pour votre projet ? et sélectionnez une ou plusieurs entrées correspondant à votre soumission.
  6. Cliquez sur Soumettre le projet.