I’ve accidentally started a long discussion due to a small and fairly insignificant bug that turned out to be more than enough for several major theme authors, reviewers and theme lead devs to chime in and share their thoughts. I usually try to avoid those scenarios, but every now and then the tension needs to be released.
These are my observations, thoughts and ideas based on my experience over the past 2.5 years with the theme directory.
Theme Reviews in 2011-2012
I have joined the WPTRT in 2011, after doing a dozen reviews as a “candidate reviewer” before getting my status approved. It was exciting and challenging to join, there was a lot of work to be done, authors were occasionally getting anxious waiting for weeks and weeks to get their themes reviewed every single time.
Since then, numerous things happened. There were several batches of updates in the guidelines, procedural enhancements for getting new reviewers on board, and the average number of “waiting” themes in the queues have been shifting in different directions.
mid-2011 vs. end of 2013
For the past 2 years I have noticed few things in the overall process that have been updated one way or the other. I can’t confirm which of them were good or bad, or should we have other updates in the guidelines, but what I see as a user/developer and reviewer is the following:
- now it’s sufficient to complete a single test review to get a reviewer status, whilst it took more than 10 “exams” (review-wise) two years ago
- there were several small updates in the guidelines and few more things added to Theme-Check, nothing quite as major
- the brilliant idea of the Theme Review Incentive program led to the first long-term position of the directory where themes are now getting approved in just a few days, and having just a couple of themes waiting for a review in every moment. Huge props to Chip and the admin team for that.
However, during the past 2 and a half years WordPress have been drastically improved in the CMS aspect and even in the Application Framework direction, while the theme regulations have been mostly focused on blogging.
I have joined the team just as many other reviewers did back then – I was curious what are those mysterious coding practices that the theme directory demands and I wanted my newly submitted theme to be reviewed quickly, so my help was accelerating that process. It wasn’t trivial to get in, I had several people monitoring my actions and reviews and sending feedback, but eventually I got in and I learned tons of new things about theme development, best practices, the Settings API and much more. Even if you know development and you tend to know the WordPress concepts, there are tons of specifics and APIs that you might be unaware of, or handy functions making use of the templating engine and specific concepts just like child themes.
Subjectivity and “retro”
Two of my biggest concerns are subjective guidelines/regulations and not being on the top of the wave. There are way too many things to check for and any reviewer couldn’t quite verify every single one of them. One might say that each reviewer should be able to point out all the rules – I think that we pay too much attention to details that are insignificant and lose time, people, resources and themes due to that.
That leads to various issues, such as:
- Themes getting rejected several times due to tiny details – this is a real culprit for enthusiast authors who refuse to apply anymore.
- Some reviewers avoid to do many reviews – it is too much time and energy consuming to run through hundreds of guidelines instead of focusing on important details only.
- Reviewers stepping on each others’ toes – the existence of “sufficient”-alike words in the unit test data requirements or the review document leads to people trying to re-review a theme after a reviewer has already submitted a comment. In my observation that would be one of the following two problems – the first reviewer is inexperienced and should be revised or so, or the second reviewer is being disrespectful and too pedantic for no apparent reason. Mistakes happen or one might miss a detail, but that’s more of an exception.
- Theme authors with business themes refuse to submit them to the repository or fail to get in as all of the guidelines focus on the blogging site and forget that WordPress is currently a CMS and millions of people use WordPress for their business sites, eCommerce stores, portfolio sites, portals and so forth, and the repository is surprisingly empty when it comes to the number of non-blogging themes.
There’s another subject that people avoid to talk about (and I won’t get into long and detailed explanation as it would lead to flames, wars, trolling or whatever), but credit links and texts are also dodgy and quite non-established. People share different opinions on what is allowed for credit links (and where) depending on what they do for a living, and I’ve been working in the IT industry for more than 10 years now and definitely try to see the bigger picture for the sake of the community.
What I would consider as an appropriate credit link is – any link in footer and/or theme options page that links to the author, if the author is 1) a freelancer, or 2) a company, related to the IT industry – which includes web development, design, hosting, some PaaS/SaaS, theme market, podcast website and everything else online that is being a part of the community and trying to give back. I like the idea of giving back for the sake of giving back, but the truth is that people should pay bills, buy groceries and provide for families before they can afford to give back, and if the link is important and is some sort of approval for their work – sure, why not? It would benefit both the repository, the developer/company and the users, that is a triple win.
As I wrote earlier, the process has been pretty flexible and vivid, sometimes a review for a new theme could take a day, or more than two months. The new incentive is great, I also keep finding more and more people willing to help with theme reviews – I gave talks for the Theme Directory, themes and reviews at WordSesh last year, WordCamp Sofia this year and we got more than 20 people reviewing themes at the last 2 contribution days over the past 3 weeks which is literally awesome. It actually turns out that there are not enough themes for new reviewers to review, and just a year ago there were 100-200 themes waiting in the queues to be reviewed!
In order to boost the WordPress repository and push it in the right way, bring new reviewers, clean the process, invite new authors and embrace variety for themes, I would consider few ideas:
- design a new process with priorities – for example, outlining 20-30 regulations that are absolutely required and would definitely reject a theme. List 100 recommended items, non of them would be critical, but if more than 10 or 15 of these are missing, then the theme would be rejected too (otherwise only a note in the ticket would suffice).
- simplify and specify the requirements – I would refer to the existing guidelines as “the comprehensive list of all possible scenarios” but stick to a shorter document with the important things. Let the theme authors worry about just a bunch of details instead of trying to think about hundreds of them. Make the process easy for reviewers too, less hassle, quicker reviews, more joy for everyone in the process. Focus on security, critical issues and several important functions and make everything else “nice to have”.
- rely on ratings and feedback – as long as a theme does not expose security holes or introduce some nasty code (or the UI is broken on standard pages) – let it in. Focus on ratings and feedback. Give people the access to secure and fairly well-developed themes, where 80% of the work is done and reviews take 20% of the time. Let people test and judge proven themes and decide if they want to deviate or downvote themes that make no sense. Create a “top rating” filter or something for the best themes, but don’t limit thousands of decent themes.
- implement some control mechanisms for reviewers and review actions – what would be the process of getting new reviewers on board and dealing with old reviewers? I haven’t been active for some time due to the process complications, but I would love to take part in a bigger, process-driven update and deal with more and more themes. But if I fail to stick to the basic guidelines or I haven’t done reviews in 9-12 months, let’s flush the list and keep it active.
- business category – go outside and ask your friends who use WordPress but don’t do development if they would build their business website with a theme from WordPress.org. I would guess that less than 10% are willing to spend enough time to find a theme that eventually looks good for anything else but a blog, or has a non-blog screenshot and definition in the first place. Build a business category for business themes, or even get further and accept WooCommerce/Easy Digital Downloads themes, One Page themes and others that people keep searching for over and over. Make the directory useful not only for newbie bloggers, but for real WordPress users. Show this new directory to all those people who claim that WordPress is still a blogging platform and wouldn’t work for a real website.
- listen to the users and the authors – ask the users and the authors what would they like to see in the directory, and get improved. Take notes on that, see what the regular WordPress user wants and looks for. Help them find what they need or educate them on what is good for them. Either way we tend to forget how does the regular user thinks just as developers often forget how would the average user use their product.
- more exposure for the directory – whenever this is ready, spend some time sharing this directory. The blogging constraints above are the reason for people to spend all of their time in theme markets. This is definitely not a bad thing, but there are so many because the original free directory doesn’t provide enough non-blogging content and all the other free themes directories are hacked. Let’s fix that.