User Guide

This project houses the source files for the Drupal User Guide. It is not a module. The Guide was written in English, and has been partially to fully translated into at least 10 other languages.

You can view the User Guide online (HTML version, in English with links to other languages in the sidebar), or download PDF and other e-book versions. See the Links section on this page for more information and other options.

Status

As of Oct. 2026 the 11.x branch of the User Guide is now written in Markdown. Previously AsciiDoc was used for formatting.

The User Guide is now completely written and edited in English. It is also being translated into at least 10 languages, and you can see the in-progress translations of the Guide via links on the Guide pages.

The User Guide project was started during the Drupal 8 development cycle by the Documentation Working Group (DocWG), as a community initiative. Members of the community write, edit, and translate the guide, using templates and following guidelines provided by the DocWG.

Links

• Current HTML version of the User Guide, including English and partial/full translations into at least 10 languages.
• Visit the E-book downloads page to download PDF, ePub, and Mobi versions of the User Guide
• Download a release or the "development version" below, or click the "Browse code repository" link in the sidebar, to see the source code used to build the User Guide.
• Contributor Guide. Contains, among other things:
  • https://www.drupal.org/docs/user_guide_guidelines/practicalities.html -- quick start guides for contributors, including translators
  • https://www.drupal.org/docs/user_guide_guidelines/pm-guide.html#pm-guide... -- instructions for starting a group to translate the User Guide into your language
• User Guide contributor chat (for editors, writers, translators):
  On Slack, use the #documentation channel
• Issue list for this project -- available tasks are tracked on issues (see Contributor Guide)
• Translation group managers should subscribe to the email list we use for announcements: https://groups.google.com/forum/#!forum/d8manual
• Automated tests and screenshot generation is now in a separate project: User Guide Tests

Maintainers

Each translation of the User Guide has one or more maintainers, its own issue "component", and the in-progress translation can be viewed on drupal.org:

Suggestions?

If you have suggestions or comments about the project, especially about templates, guidelines, or project management, please add an issue. You can also add an issue if you find a problem in the guide. There are issue "Components" in this project for project management, guidelines content, guide content, translations, and templates.

Note about branches/versions

The current working branch for the project is the 11.x branch. This is what will get published on Drupal.org, and edits to the guide's content should be made in this branch.

We currently make "branches" of this project corresponding to Drupal Core major versions:

• We had an 8.x-0.x branch corresponding to Drupal 8.0.x when we started out.
• There was no 8.1.x version.
• We used to make new branches for each minor version of Drupal Core: 8.x-3.x for Drupal Core 8.3.x, 8.x-4.x for Drupal Core 8.4.x, etc. But that resulted in lots of branches with no difference between them. So for now we only increment the minor version when the new minor version of Drupal core requires significant changes to the guide content.
• Translations are in progress on the latest branch.