Documentation Is Getting An Overhaul

Having high-quality documentation available for Drupal.org 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! 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
• Updates to Drupal.org from the last year that make documentation pages easier to maintain
• In progress changes to the information architecture of handbook pages
• Upcoming changes to Drupal.org 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.

This is a topic I've talked about in these previoius sessions, Lets Talk Documentation, and Lets Keep Talking About Documentation. Both times leading to productive converations that have helped to inform much of the work taking place currently. And something I hope to continue with this discussion as well.