Learning Lab
Courses Learning Paths For Organizations Docs
Sign in

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 organization 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 in your own organization.

Reusing a course between two organizations on GitHub.com

We'll assume you've got a source organization that owns the existing courses, and a target organization that you'd like to own your new courses.

  1. Fork the course repository from the source organization to your target organization.
  2. Fork the template repository from the source organization to your target organization.
  3. Install the Learning Lab app on your target organization.
  4. Visit your organization's new course creation page, replacing <YOUR-ORG> with the name of your target organization:
     https://lab.github.com/<YOUR-ORG>/new
  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 organization on GitHub Enterprise Server that you've selected to house your Learning Lab courses. This organization 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. Visit your organization's new course creation page, replacing <YOUR-LEARNING-LAB-URL> with the URL to your Learning Lab instance, and <YOUR-ORG> with the name of your target organization:
     https://<YOUR-LEARNING-LAB-URL>/<YOUR-ORG>/new
  9. Enter the course repository's name in the text box.
  10. Click Create course