Dev-squad GitHubGitHubGitHub 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/ triage: Thursdays 07:00 UTC
Once your application has been approved, and your topic has been vetted, you are ready to get started on your Tutorial! Bookmark your topic’s GitHubGitHubGitHub 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, as you’ll be using this to track your progress, and receive feedback from other team members.
Copy and paste the following checklist as a new comment in your content’s GitHub issue. You can then use this checklist as your guide through the rest of the creation process.
# Tutorial Development Checklist
- [ ] Tutorial [created](https://make.wordpress.org/training/handbook/tutorials/creating-a-tutorial) and announced to the team for Q/A review
- [ ] Tutorial reviewed and [ready to publish](https://make.wordpress.org/training/handbook/tutorials/publishing-a-tutorial)
- [ ] Tutorial [submitted and published to WPTV](https://make.wordpress.org/training/handbook/tutorials/publishing-a-tutorial/#1-submit-your-video-to-wordpress-tv)
- [ ] Tutorial published on WPTV
- [ ] Tutorial [captioned](https://make.wordpress.org/training/handbook/tutorials/publishing-a-tutorial/#2-generate-subtitles-and-a-transcript-for-your-video)
- [ ] Tutorial [created on Learn.WordPress.org](https://make.wordpress.org/training/handbook/tutorials/publishing-a-tutorial/#3-create-edit-your-workshop-post)
- [ ] Tutorial post reviewed for grammar, spelling, etc.
- [ ] Tutorial published on Learn.WordPress.org
- [ ] Tutorial [announced to Marketing Team](https://docs.google.com/spreadsheets/d/1rY9gyA0KljjlinPE2B0S2qfsN8Nz24_N_KzqB5CrYZM/edit#gid=469255212) for promotion
Sound will play an important part in your tutorial, 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-cancelling apps available, such as:
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.
To find images to use in tutorials, 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.
Name your tutorial appropriately. Action words like create, use, explore, help to draw the reader’s attention. Make sure to use sentence case on your title card.
Aim for your tutorial to be between 5 – 10 minutes in length. Shorter videos can be more engaging and easier to follow for viewers. We also welcome longer WordCampWordCampWordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. or MeetupMeetupAll local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. type tutorials of 40-45 minutes duration. Please stay within the time frame which was approved.
Write out your script or use an existing lesson plan! This is the part where you gather all of your thoughts, develop an outline for what you would like to present, and begin to work on any supporting materials, such as slides or screenshots.
Start your tutorial video with an introductory slide and clear introduction.
Remember to share the objectives or outcomes of the tutorial to help guide the viewer. Learning objectives are more powerful if they are actionable and measurable.
When creating slides and graphics, keep the ‘coherence principle’ in mind: People learn better with less extraneous words, pictures and sounds.
Once you’ve recorded your tutorial, it is time to edit. Cut out any mistakes and place your recording into the correct order.
Submit your tutorial to the training team for a review. This can be done by either uploading the video to the GitHub tracking issue, or linking to it in the issue, if you have it hosted elsewhere.
The next step is to wait for a member of the training team to review your tutorial. As a general rule, tutorials are left open for review for a period of two (2) weeks from the date that they were made available for review.
It is recommended that there should be at least three (3) reviews completed on a tutorial before it can be published.
However, this is more common with tutorials from newer contributors. Content creators who have more experience preparing and publishing tutorials for Learn WordPress will typically publish after three reviews OR once the two-week review period has concluded.
If you’re not sure, it’s always a good idea to check with a member of the training team in the #training channel in SlackSlackSlack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/..
When your video is ready and approved by the Training team, upload it to WordPress.TV. Where it says “categoryCategoryThe 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging.” check the box that says “Learn WordPress.” Once the video is uploaded and published, please add subtitles to the tutorial.
Once the video is uploaded on WordPress.tv will be shared with the wider Training team and other Make Teams.
Tutorial creators should also submit up to five quiz questions and answers with each tutorial. This will help learners test and solidify their newly acquired knowledge and skills. Follow this link for more information.
A: You will be uploading your video to WordPress.TV, so please keep in mind its Video Submission Guidelines.
Q: Is there a preferred length of recording?
A: We don’t want to place an exact time limit on tutorials, but it is encouraged to stay within 5 – 10 minutes, unless a longer version has been agreed.
A: Not necessarily, but you can. Many tutorial presenters tend to include their slides in the video making.
Q: I don’t feel comfortable editing, writing and speaking. Do I have to do it all?
A: No! A lot of care and effort goes into making a video, or any presentation. If there is a particular part of the process you excel at, feel free to include that in your application or reach out in the #training team channel on the Make WordPress Slack to find if there would be anyone interested in helping to divide the tasks with you. Tutorials can be created and presented by others in the Training team or WordPress community.