Write a Learning Lab course
Use Learning Lab's strengths for fast feedback to author your own course.
Start Write a Learning Lab course Join 516 others!
Learning Lab helps people build real world skills through hands-on activities. This course streamlines the course building process, and gives you all the tools you need to help others learn.
Register for this course to get the starter files needed to build your Learning Lab course, or complete the course steps for a fully guided experience. If you choose to complete the course, you'll be able to:
- Identify the structure of a Learning Lab course
- Define a title and description for your course
- Define a template repository
- Create course steps
- Create responses
- Publish a course to GitHub Learning Lab
Steps to complete this course 31
-
Choose a topic for your course
Choose what you'd like to teach through Learning Lab, or borrow one of our suggestions for practice.
-
Welcome
Decide whether to complete a guided course, or use boilerplate as is.
-
Break your course into smaller steps
Break down what you'd like to teach into smaller learning objectives.
-
Give your course a title
Name your course so learners can find it.
-
Add some descriptions to your course
Give your course a description and tagline so learners can identify it.
-
Merge your learning objectives
Merge the pull request breaking down your course topic into smaller learning objectives.
-
Approve the course metadata
Approve the pull request containing the course's metadata.
-
Reference the template
Edit the config file to reference your chosen template repository.
-
Map learning objectives to events
Map the learning objectives you wrote to specific events from GitHub webhooks.
-
Point to the template repo
Designate a template repository from which to clone.
-
Give the learner's repo a name
Designate a name for the repository when it is created for the learner.
-
Create an outline of learning objectives as events
Using the same strategy of mapping learning objectives to events, create an outline of events for your course.
-
Choose the example that shows the three phases
Apply a label that corresponds to the example showing the three phases of a step.
-
Approve the repo setup
Approve the template repo information
-
Create an issue using Learning Lab
Use the `before` block to create an issue in the learner's repo.
-
Create the first response
Write the first response, phase 1, for the first step of your course.
-
Write the first Learning Lab action
Write the first Learning Lab action for a response into your course's configuration file.
-
Create your first response
Add content to the repo's first issue.
-
Write a gate
Write a gate to check the user's first step
-
Name your first step and give it a description
Identify the first step so the learner knows what's expected.
-
Trigger your first step with a GitHub event
Add a pull_request.opened event.
-
Write feedback for the learner
Write feedback into the feedback response for the learner to let them know they've done it right.
-
Write the config logic
Write the config logic for both responses to the learner in their first step.
-
Validate a learner's pull request
Add a gate to determine if the learner took the expected action.
-
Use contextual information to validate
Add options to the gate action.
-
Create course metadata
Add the course metadata like title and description to the configuration file.
-
Respond to a learner's successful pull request
Use a respond action when a learner opens their pull request.
-
Import the course
Import this repository as a course on GitHub Learning Lab.
-
Close the issue
To signal that you've tested your course, close this issue.
-
Add a README to your course
Write a longform description for your course.
-
Approve the steps
Submit an approval for the steps pull request.
Average time to complete
38 minutes
Free
All public courses on Learning Lab are free.