Skip to main content

Submitting your repository to GitHub Community Exchange

You can submit your repository to GitHub Community Exchange for others to view or contribute to.

About repository submissions

Only public repositories owned by personal accounts can be submitted to GitHub Community Exchange.

There are three types of repository submissions:

  • Learn. A repository to share step-by-step instructions to build a project.
  • Collaborate. A repository seeking collaborators to work on a project.
  • Learn and Collaborate. A repository which is a combination of Learn and Collaborate.

Consider what the main purpose of your repository is when choosing the type of submission for your repository.

To promote your project and make it more discoverable to other students, you should assign one or more topics and GitHub Student Developer Pack offers to your repository. For more information, see "Classifying your repository with topics."

Once a repository has been submitted to GitHub Community Exchange, it will be published immediately with the purpose, topics, and offers you've chosen. The GitHub Community Exchange community moderates all repository submissions.

Submission requirements

Your repository must meet a minimum set of requirements for a submission to be accepted. During the submission process, if the submission criteria hasn't been met for your selected repository, you will be notified of the missing items.

For a submission with a purpose of Learn, your repository must have:

  • A description.
  • A LEARN.md file to provide step-by-step instructions, with text and/or media, on how you built your project. Ideally, your LEARN.md file will deconstruct your project into small components and provide thorough details of each step, so that other students can code their project by following your instructions.
  • A README.md file to provide a detailed description of your project.

For a submission with a purpose of Collaborate, your repository must have:

  • A description.
  • A README.md file to provide a detailed description of your project.
  • One or more issues for collaborators to work on.

A good repository submission for both Learn and Collaborate purposes, is a repository that follows community standards. For more information, see "About community profiles for public repositories."

Submitting your repository

  1. From your GitHub Global Campus dashboard, navigate to the GitHub Community Exchange home page.
  2. Above the list of repositories, to the right of the search and dropdown filters, click Add repository. Screenshot of the Add repository button
  3. Use the What is the purpose of your submission? drop-down menu and select one or more entries matching your submission. Screenshot of the purpose dropdown for a repository submission
  4. Use the Which repository would you like to use? drop-down menu and select the repository for your submission. If the submission criteria hasn't been met, you will be notified of the missing items. Screenshot of the repository dropdown for a repository submission
  5. Use the Which offers did you use for your project? drop-down menu and select one or more entries matching your submission. Screenshot of the offers dropdown for a repository submission
  6. Click Submit the project.