Reviewing Tutorial Submissions

When a new tutorial submission comes in, it needs to be reviewed for Content— is it something that is worthwhile having on Learn WordPress?

Submitted tutorials are added to the Learn WordPress dashboard in the ‘needs vetting’ status, you can view these tutorials here: https://learn.wordpress.org/wp-admin/edit.php?post_status=needs-vetting&post_type=wporg_workshop

When you open up a tutorial for review you will find the information and details as submitted by the applicant. Use this information to process your review and leave notes about it as you go.

Where do I leave notes?

There is a blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. editor sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. for notes that you can access by clicking on the icon alongside the settings cog at the top right of the page:

Whenever this guide says to leave a note, that is where you will do it. These notes will only be visible to other tutorial reviewers and site administrators – they are not public and are not sent to the applicants. All previous notes will be listed in the notes area, together with the date and username of the person who left them.

Top ↑

Where do I reply to applicants?

All emails are sent from the Learn WordPress Help Scout inbox – this ensures that emails come from learn@wordpress.org and can be replied to by any other individual with access to the inbox. If you need access to Help Scout please ask in the #training channel of the Make WordPress Slack. If this guide says you must email an applicant, then Help Scout is where you can do that. When you email an applicant, you must make sure the URLURL A specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org for the Help Scout thread is added to the tutorial notes (you can copy the URL from your browser address bar when you’re viewing the thread).

Top ↑

Reviewing Topics

When reviewing a tutorial topic you need to follow this process.

Top ↑

1. Check for existing content

Check if a tutorial with the same topic already exists in the dashboard either with a published or to be published status: https://learn.wordpress.org/wp-admin/edit.php?post_type=wporg_workshopyou must check in the dashboard, rather than the frontend in case a similar tutorial is awaiting publication. Then follow the steps below.

If you find a published tutorial that is similar in content, then leave a note on the tutorial that links to the existing one and reply to the applicant to let them know about it using the “TUTORIAL: Declined (topic already exists)” saved reply. Update the application status to “Declined” and add a note explaining the reason along with the Help Scout link.

If you find an approved (but not published) tutorial that is similar in content, then contact the presenter for the approved tutorial through Help Scout and invite them to collaborate with the new applicant if they wish to do so. Send them the new applicant’s email address, but don’t copy them into the email – use the “TUTORIAL: Notify about similar application” saved reply.

You must also email the new applicant to let them know about the approved tutorial and that you have passed their email address on to the existing presenter – you can use the “TUTORIAL: Declined (topic already in planning)” saved reply for this. Update the application status to “Declined” and add a note explaining the reason along with the Help Scout link.

If you find another tutorial needing vetting that is similar in content, then email both applicants together and invite them to collaborate on the tutorial – you can use the “TUTORIAL: Invitation to collaborate” saved reply for this. Update the application status to “Declined” and add a note explaining the reason along with the Help Scout link.

If there are no existing tutorials similar in content and you feel that it would be valuable for Learn WordPress, then we can move forward with the application. If you are not sure of its value then ask in the #training channel for a second opinion. If the tutorial topic is approved, move on to the next section for vetting the applicant.

Last updated: