Lesson creation process

Lessons can be created for one of two purposes:

  1. As part of a Learning Pathway course module (or group of Lessons)
  2. As a stand-alone Lesson

When working on Lessons that form part of a Learning Pathway, it’s generally a good idea to check in with the contributor(s) who are managing the specific Learning Pathway, to ensure that the content you are working on matches the intent of the pathway in question.

The Training Team uses the Learn.WordPress.org GitHub repository, and more specifically, the LearnWP Content – Development project board, to create and manage Lesson content.

Lesson creation follows this process:

  1. Create a new Content Development (general) GitHub issue, filling out the template with the details of the Lesson you want to create. Part of this process will require you to gather any relevant links to documentation, blog posts, or other content that will assist in Lesson creation.
  2. The new issue is vetted by members of the training team, and the Lesson details are either confirmed or more information is requested.
  3. Once the Lesson has been approved, you can start gathering any relevant links to documentation, blog posts, or other content that will assist in Lesson creation.
  4. Create your Lesson, and upload the Lesson content for reviews.
  5. Members of the training team will review the Lesson following the Guidelines for Reviewing Content.
  6. Once the review is complete, the video of the Lesson can be uploaded to WordPress.tv, exported to YouTube, and added to a new Lesson on Learn.WordPress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/.
  7. Once all completed, add a final comment to the GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ issue that says //publish. This will trigger a GitHub automation that will apply the applicable labels and close the issue.

Vetting Lesson issues

Vetting Lesson issues is the process of reviewing a new Lesson idea to assess the idea for relevance and priority.

Lesson ideas are typically only vetted when they are created by newer contributors. Experienced Training Team members who are already very familiar with preparing and publishing Lessons for Learn WordPress will typically be allowed to start working on the content once the Lesson issue has been created.

You can read more about how Lessons are vetted on the Vetting Topic Ideas handbook page.

Last updated: