Overview - Documentation Guidelines, Policies, and Standards

Last updated on
8 August 2023

This documentation needs work. See "Help improve this page" in the sidebar.

Part of the mission of the Documentation Working Group (DocWG) is to ensure that excellent documentation guidelines, policies, and standards are in place for Drupal Core and contributed projects (modules, themes, distributions).

We encourage all members of the Drupal community to contribute to documentation! See Community Documentation for more vital information.

If you have questions or comments about these guidelines, contact the DocWG.

Standards in this section

This section deals with the community documentation pages on Drupal.org and their structure, the API pages, and how to handle obsolete or duplicate documentation.

Standards and policies located elsewhere

Text on Drupal.org

Content style guide gives details of recommended styles, wording and agreed spelling on a range of terms on Drupal.org. These are also relevant for documentation pages.

Project documentation

  1. Documentation of Projects has guidelines for what documentation should be provided as part of Drupal core or contributed projects.
  2. Help text standard outlines the structure and content of the help text for a module that is displayed on the Help page within a Drupal site.
  3. Content style guide has guidelines and agreed spelling of texts on Drupal.org that should also be followed for the wording of README files, API documentation embedded in code comments, help text and user interface text for modules displayed within a Drupal site, etc.
  4. Interface text lists additional guidelines specifically for user interface text.
  5. API documentation and comments standards have guidelines for in-code comments for Drupal Core and contributed projects.

Other

Help improve this page

Page status: Needs work

You can: