Documentation Is Getting An Overhaul


Having high-quality documentation available for is key to gaining wider adoption, growing the community, and the overall success of the Drupal project. I want to share the work related to documentation going on in the community, as well as some of our plans for continued improvement in the future.

The community, the Drupal Association, and the Documentation Working Group have all been hard at work improving both the processes and the tools we all use to manage our documentation. And we’re making huge progress! By the time DrupalCon happens much of this work will already be in use on This session is for anyone who wants to learn about these changes, and what to expect in the future.

In this session I want to share the progress being made on various initiatives. I’ll start by discussing some of the pain-points that have been identified, and look at how the conversation has evolved over the last couple of years, and then I’ll share information about the following initiatives that are addressing these pain-points:

  • The Drupal 8 user manual initiative
  • Documentation sections and section maintainers
  • Updates to tools and information architecture that make documentation pages easier to maintain, and how to use them
  • Ungoing changes to that facilitate better collaboration, and maintainership of documentation pages

Finally, I would like to make sure there is time left at the end of the session for others to share their ideas about how documentation could be further improved and to provide feedback on recent and proposed changes.

Session Track

Core Conversations

Experience Level


Drupal Version

When & Where

Wednesday, 28 September, 2016 - 13:00 to 14:00
Liffey Meeting 4 | New Relic