Write the course steps

[github-learning-lab]

Great! Now let's work on the before: block.

before:

Anything in this block occurs before the learner can access their course repository.

Learning Lab actions

Actions are reusable modules that each course has access to. They are each designed to do very specific things, and nothing more. This is to optimize for reusability and simplicity. The documentation contains a listing of 📖 all available actions.

Step 7: Add to the before block

We'll use the 📖 createIssue action to create an issue for the learner with some initial instructions. The createIssue action requires two 📖 options:

• a title
• the body of the response

We'll define both of those here, but we'll create the body in the next step.

⌨️ Activity: Add the createIssue action

1. Add a createIssue action in the before: block
   • Note: Since there are multiple suggested changes, you can go to the "Files changed" tab and accept them as a batch

---

I'll respond below when I detect a commit on this branch.

[github-learning-lab]

Great! Now, the repository will have an issue for the learner.

Step 9: Creating a response

In the last step, we referenced a file titled welcome-text.md, but it doesn't exist. Learning Lab automatically looks in the 📖 responses/ directory for all content files. Let's add it.

⌨️ Activity: Adding a response

1. In the /responses/ folder, create a new file titled welcome-text.md
   • Note: If you're working on GitHub.com, you may need to navigate to the Code tab, checkout to the write-steps branch, and click Create new file, or use this shortcut
2. In that file, add some content that will appear to the learner in the welcome issue
3. Add an instruction for the learner to open a new pull request titled "Add name to README" in which they add their name to the README file

---

I'll respond below when I detect a commit on this branch.

[github-learning-lab]

Great! The learner's repository will now be setup with a single issue.

Steps in Learning Lab

Let's now dive into the steps:. This block is composed of 📖 steps that are triggered by events on GitHub, and in turn certain 📖 actions take place. actions in this context are NOT the same as GitHub Actions.

Each step maps directly to something that the user will do. User interaction on GitHub triggers the step, and Learning Lab responds. The user interaction could be creating a pull request, closing an issue, or editing a file. When designing a course, it's important to plan for the user interactions to reflect what you want them to learn.

Best practices for steps

For example, you could write a lot of text and have the user close the issue when they're done. But, unless your text was telling them how to close an issue, that reaction doesn't make sense. Try to find a way to have the user demonstrate their knowledge, like by committing a function to a branch. Let the user show they understand to trigger the next step.

See 📖 best practices in the Learning Lab docs for more suggestions.

Step 9: Naming our first step

Let's name our first step. We will give it a title and a description. These will be shown on Learning Lab, and they help course authors stay organized in the config.yml file. The docs show 📖 syntax and examples of how steps are shown to the learner.

⌨️ Activity: Naming our first step

1. Add a title and description for the first step
   • Note: You can do this by editing the file, or accepting my suggested change

---

I'll respond below when I detect a commit on this branch.

[github-learning-lab]

Suggested change

	- title: # the title of the step, shown to the learner in the course progress page
	- title: Create a new PR

[github-learning-lab]

Suggested change

	description: # the event that will trigger the actions to be executed, full list at https://developer.github.com/v3/activity/events/types/
	description: Add your name to the README.md file in your new PR