Reuse an existing course

We've made it easy to automatically load GitHub-created courses to your Learning Lab installation. However, you'll sometimes need to reuse a course from one owner to another if, for example, you've created a course on GitHub.com, and then you'd like to modify the course for use in GitHub Enterprise Server. This document covers that scenario.

As a reminder, each course has:

  • a course repository, and
  • a template repository

You will need read access to both of these repositories in order to reuse them.

Reusing a course within GitHub.com

We'll assume you've got a source owner that owns the existing courses, and a target owner that you'd like to own your new courses. Owners can be individuals or organizations.

  1. Fork the course repository from the source owner to your target owner.
  2. Fork the template repository from the source owner to your target owner.
  3. Install the Learning Lab app on the target owner.
  4. Click on the + on the top-right of any page on Learning Lab, or navigate to https://lab.github.com/:owner/new, replacing :owner with the login for the target owner.
  5. Enter the course repository's name in the text box.
  6. Click Create course

Reusing a course between GitHub.com and GitHub Enterprise Server

We'll assume you've got a target owner on GitHub Enterprise Server that you've selected to house your Learning Lab courses. This owner is usually an organization that can be used only for Learning Lab, or it can have multiple uses.

  1. Clone the course repository to your machine.
  2. Create a repository in your target organization with the same name as the course repository you just cloned.
  3. Push your local repository to the target organization.
  4. Clone the template repository to your machine.
  5. Create a repository in your target organization with the same name as the template repository you just cloned.
  6. Push your local repository to the target organization. Note: your template repository may contain multiple branches that the course makes use of. If this is the case, ensure you've pushed every branch in the repository to your target organization.
  7. Install the Learning Lab app on your target organization.
  8. Click on the + on the top-right of any page on Learning Lab, or navigate to :url/:owner/new, replacing :url with the URL of your Learning Lab installation, :owner with the login for the target owner.
  9. Enter the course repository's name in the text box.
  10. Click Create course