Running a Theme Review Session

Information for contributor day organizers

When running a review session, we recommend that you first present the team and what we do, and introduce contributors to the Theme Review Team’s blog on https://make.wordpress.org/themes/.

This is where you can find the step by step guide to becoming a reviewer and the theme requirements.

During the introduction you will not need to or have the time to go through the entire requirements page, but emphasize that we review license and security first, before design.

It is also helpful to show how to log into Slack, and where to find the Theme developer handbook and the code reference.

After this short introduction, a lot of your time as a group leader will likely be spent helping people set up a local environment, which is step 4 of the Become a reviewer guide.

When this is done, the contributors need a theme to review.

-Normally when someone starts reviewing a theme, they are assigned to a ticket in the themes Trac, they post a review, and wait up to seven days for the theme author to reply. 

We know that this format may not be suitable for a contributor day where the time is limited and where contributors may want to meet and try different teams during the day.

-Contributors should not be expected to complete a full review or to feel pressured into having to continue working on their ticket after the contributor day is over.

We recommend that you either:

  1. Select a theme from the top of the queue, and review the theme together as a group.  Make sure that everyone is included in the discussions.
  2. Let contributors pick a theme each from the queue, but without being assigned to the ticket.  By leaving the ticket status as new they will be able to add the result of their review, but will not need to do the follow up review.  Contributors can also pair up and review a theme together.
  3. Let contributors review their own theme with the help of the plugins, and show them how they can upload it to the theme directory.
  4. Let contributors request a theme to review via the Theme Review Slack channel. -Depending on who is online to see the request, this may take some time, so we encourage organizers to prepare ahead of time and request a couple of tickets to review before the contributor day starts.

Trac tickets that have been assigned during a contributor day will often need to be reassigned, so we would like to ask that you create a list of wordpress.org usernames (or a list of ticket numbers) and send them via slack to either:

  • @kafleg
  • @williampatton
  • @acosmin

To help with the actual review, we are writing a “How to do a review” guide. We also have documentation about using the themes Trac.

We would love to hear what we can improve to help contributors get started, if you are able to write down frequently asked questions about the process, the requirements or anything else, that would be very helpful.