When:
to
Room:
Room 2
Tags:
developer relations & integrations, drupal & open source 101, user experience, accessibility, & design
Track:
SVG
owc icon_new brand
community health

Improving and contributing Drupal Documentation. 2025 edition

Improving and contributing Drupal Documentation. 2025 edition

Vladimir Roudakov (VladimirAus), Janna Malikova (Jannakha)

Lately we've organised a series of help contribution sprints focused on reviewing, updating, and enhancing Drupal documentation based on feedback from the Slack documentation channel. We will share insights gathered over the past two years of teaching Drupal at the college and for private companies, combined with recent initiatives from the Drupal Association and successful documentation strategies from other open-source projects. We will also explore how new AI tools can be leveraged to create, promote, and improve documentation.

Prerequisite
This sessions is aimed at the new generation of Drupal help and guide contributors.

Outline
1. The Current State of Drupal Documentation: An overview of how up to date and related existing Drupal documentation.

2. Contributing to Drupal Documentation: A step-by-step guide to the contribution process, including:
2.a Updating guides
2.b Contributing to API documentation

3. Tools and Resources: Exploring the tools and resources available to documentation contributors, including tools for outdated content, style checkers, translation and community channels.

4. Leveraging AI for Documentation: Examining how AI tools can assist in creating, maintaining, and improving documentation.

Learning Objectives
📄 Highlight areas within Drupal's documentation that need improvement.
📄 Contribute to Drupal documentation by creating, updating, and reviewing pages.
📄 Utilise available tools and resources for documentation contributions.
📄 Apply best practices for collaborating within the Drupal documentation community.
📄 Demonstrating how modern AI tools can be used to improve documentation workflows.
📄 Get involved in documentation sprints and other community efforts.

Experience level
Beginner