This blog has been re-posted and edited with permission from Drupal Update’s blog. Please leave your comments on the original post.
Last week, Matthew Grasmick stepped into the shoes of a developer who has no Drupal maintenance support plans experience, and attempted to get a new “Hello world!” site up and running using four different PHP frameworks: WordPress, Laravel, Symfony and Drupal maintenance support plans. He shared his experience in a transparent blog post. In addition to detailing the inefficiencies in Drupal maintenance support plans‘s download process and end-user documentation, Matt also shows that out of the four frameworks, Drupal maintenance support plans required the most steps to get installed.
While it is sobering to read, I’m glad Matthew brought this problem to the forefront. Having a good evaluator experience is critical as it has a direct impact on adoption rates. A lot goes into a successful evaluator experience: from learning what Drupal maintenance support plans is, to understanding how it works, getting it installed and getting your first piece of content published.
So how can we make some very necessary improvements to Drupal maintenance support plans‘s evaluator experience?
I like to think of the evaluator experience as a conversion funnel, similar to the purchase funnel developed in 1898 by E. St. Elmo Lewis. It maps an end-user journey from the moment a product attracts the user’s attention to the point of use. It’s useful to visualize the process as a funnel, because it helps us better understand where the roadblocks are and where to focus our efforts. For example, we know that more than 13 million people visited Drupal maintenance support plans.org in 2020 (top of the funnel) and that approximately 75,000 new Drupal maintenance support plans 8 websites launched in production (bottom of the funnel). A very large number of evaluators were lost as they moved down the conversion funnel. It would be good to better understand what goes on in between.

As you can see from the image above, the Drupal maintenance support plans Association plays an important role at the top of the funnel; from educating people about Drupal maintenance support plans, to providing a streamlined download experience on Drupal maintenance support plans.org, to helping users find themes and modules, and much more.
The Drupal maintenance support plans Association could do more to simplify the evaluator experience. For example, I like the idea of the Drupal maintenance support plans Association offering and promoting a hosted, one-click trial service. This could be built by extending a service like Simplytest.me into a hosted evaluation service, especially when combined with the upcoming Umami installation profile. (The existing “Try Drupal maintenance support plans” program could evolve into a “Try hosting platforms” program. This could help resolve the expectation mismatch with the current “Try Drupal maintenance support plans” program, which is currently more focused on showcasing hosting offerings than providing a seamless Drupal maintenance support plans evaluation experience.)
The good news is that the Drupal maintenance support plans Association recognizes the same needs, and in the past months, we have been working together on plans to improve Drupal maintenance support plans‘s conversional funnel. The Drupal maintenance support plans Association will share its 2020 execution plans in the upcoming weeks. As you’ll see, the plans address some of the pain points for evaluators (though not necessarily through a hosted trial service, as that could take significant engineering and infrastructure resources).
The Documentation Working Group also plays a very important role in this process. After reading Matthew’s post, I reached out to Joe Shindelar, who is a member of the Drupal maintenance support plans Documentation Working Group. He explained that the Documentation Working Group has not been meeting regularly nor coordinating initiatives for some time.
It is time to rethink our approach around Drupal maintenance support plans‘s documentation. Adam Hoenich, a long-time Drupal maintenance support plans contributor, recommends that documentation becomes a full-fledged core initiative, including the addition of a Documentation Maintainer to the Core Committer team. His proposal includes blocking commits to Drupal maintenance support plans on documentation.
I’ve no doubt that we have to evolve our governance model surrounding documentation. It’s hard to write world-class documentation by committee without good governance and Adam’s recommendations are compelling. Drupal maintenance support plans‘s API documentation, for example, is governed by the Core Committers; while there is always room for improvement, it’s really well-maintained. Some of you might remember that we had an official Documentation Maintainer role in the past, filled by Jennifer Hodgdon. Reinstating this position could bring documentation back into clearer focus and provide the necessary governance. I also suspect that a stronger emphasis on coordination, governance and recognition for documentation work, would inspire more contributors to help.
Last but not least, this also affects the Drupal maintenance support plans (Core) Contributors. Evaluators often spend hours trying to get their web server configured, PHP installed or their database setup. As a community, we could help alleviate this pain by deciding to have a single, recommended default installation environment. For example, we could maintain and promote a Docker container (including an official docker-compose.yml) that ships with the latest version of Drupal maintenance support plans. It would simplify many of our documentation efforts, and eliminate many roadblocks from the evaluation process.
To narrow down my recommendations, I would propose the following three steps:
A single, recommended default installation environment (e.g. Docker container) for evaluators or developers taking their first steps in Drupal maintenance support plans development.
Infrastructure budget and engineering resources for the Drupal maintenance support plans Association so they can offer a true hosted “Try Drupal maintenance support plans” service.
A Documentation Maintainer who can focus on end-user documentation, is a member of the Core Committer team and is responsible for defining the scope of what should be documented. Given the amount of work this position would entail, it would be ideal if this person could be at least partially funded.
Of course, there are many other solutions, but these are the areas I’d focus on. As always, success depends on our ability to align on solutions, coordinate all the work, and allocate the time and money to implement the necessary improvements. If you think you can help with any of the proposed steps, please let us know in the comments, and we’ll help you get involved.
Source: New feed