Handbook style guide

A style guide provides consistency throughout the handbooks, and offers guidelines for individual page structure, formatting, and markup, as well as for language usage, spelling, and capitalization.

All page submissions and edits must follow these guidelines. Updates to the handbooks submitted to the moderation queue will not be published until they conform to the Drupal style.

For a description of the Drupal handbooks, see the Handbooks overview.

For help with adding pages or editing pages, see the End user guide. All members of drupal.org can now create new pages in the handbooks. But when someone else updates a page you created, Drupal tracks that person as the page's author, and you lose ability to edit it. To update the page, either create a documentation issue that provides the update, or create an issue as a request to join the documentation team. When the request is approved, you will have permission to edit most handbook pages.

Embedded documentation (the Help system that is available within a Drupal site) has somewhat different style requirements. For more information, see the Embedded Documentation section.