Creating a lesson

Once you’ve received confirmation to go ahead with creating your Lesson, you should follow the following steps.

A note on Lesson content.

When preparing or recording your Lesson, please keep the following guidelines in mind.

  • The Lesson should follow the WPTV Submission Guidelines
  • The Lesson should follow the Brand Guidelines for Learn WordPress
  • The Lesson should follow the Promotional Guidelines for Learn WordPress
  • Media assets used must be licensed CC0
    • you can make use of 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. or Openverse media

The Training Team is here to help

At any point during the Lesson creation process, if you need some guidance or an early review of what you’re working on, feel free to reach out to the Training Team for help.

You can upload any resources you need feedback on to the comments of 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. issue, and then share the link in the Training Team SlackSlack Slack is a Collaborative Group Chat Platform The WordPress community has its own Slack Channel at channel, and ask for feedback. 

Top ↑

Step 1: Add Lesson creation checklist

If you haven’t already, add the Lesson creation checklist to your Lesson issue in GitHub.

Top ↑

Step 2: Finalize your Lesson title

Finalize your Lesson title based on feedback submitted during the vetting process. Action words like create, use, and explore, help to draw the reader’s attention. 

Top ↑

Step 3: Write script

Start by writing out your Lesson script (or use an existing Lesson plan!) 

This is the part where you gather all of your ideas, and links to existing materials, develop an outline for what you would like to present, and begin to work on any supporting materials, such as slides or screenshots. Your script does not need to be a full blog post, you could just make short notes of what you plan to cover, whatever works best for you.

Top ↑

Step 4: Create graphics

The Training Team provides a title card template that you are welcome to use and modify to fit your needs. However, you are also welcome to select a graphics program, such as Canva, Google Slides, or Wordle, to create visually appealing slides, infographics, and design elements.

Make sure to use sentence case when adding the title to your title card. Example: Use “An introduction to WordPress” rather than “An Introduction to WordPress”.

To find images to use in your presentation, you can use resources like OpenVerse, Pixabay, or UnSplash, but do take time to check each image’s license to ensure you are using the images correctly.

When creating slides and graphics, keep the ‘coherence principle’ in mind: People learn better with fewer words, pictures, and sounds.

Top ↑

Step 5: Choose screen-recording software

Choose a software program to record your screen and audio. Some examples include: 

Top ↑

Step 6: Ensure Clear Sound

Sound will play an important part in your Lesson, so try to use high-quality sound. If you don’t have access to a microphone, use a headset if possible. 

There are also noise-canceling apps available that you can try:

Alternatively, you can try post-recording audio enhancement tools:

Top ↑

Step 7: Record your Lesson

Now that you have gathered all the necessary information, you can start recording your video.

Make sure to speak clearly and slowly. It’s often better to slow down slightly from your usual conversational voice, as it makes it easier for the viewer to understand. 

Start your Lesson video with an introductory slide and a clear introduction. 

Share the objectives or outcomes of the Lesson to help guide the viewer. Learning objectives are more powerful if they are actionable and measurable. Try and create learning objectives that follow Bloom’s Taxonomy, starting each objective with a verb.

Aim for your Lesson to be between 5 – 10 minutes in length. Shorter videos can be more engaging and easier to follow for viewers. 

Once you’ve recorded your Lesson, it is time to edit. Cut out any mistakes and place your recording in the correct order. Watch through it once or twice, to make sure there are no mistakes or further edits required.

When your Lesson is ready for review, you can submit your Lesson to the Training Team for review. This can be done by uploading the video to the GitHub Lesson issue. If you have the video hosted on an external service like Vimeo, you can link to it in the issue.

Last updated: