Contributor Guide content types

Last updated on
17 February 2021

Most of the content in the Guide is divided up into 5 types: Contributor Skill, Contributor Task, Contributor Role, Contribution Area, and Contributor Reference Information. So, if you have content to add, ask yourself these questions to figure out which content type to use:

  1. Does your content provide a step-by-step guide to achieving a well-defined goal? If yes, add a Contributor Task item. (Examples of tasks: Update the issue summary for an issue. Resolve a Documentation issue report.)
  2. Does your content describe a short-term or long-term "position" in the Drupal community that someone can fill? If yes, add a Contributor Role item. (Examples of roles: Mentor. Contributed module maintainer. Meeting organizer.)
  3. Does your content describe a piece of knowledge that is useful in performing a task or filling a role, and provide resources for how to learn it? If yes, add a Contributor Skill item. (Examples of skills: PHP programming. Using Git.)
  4. Does your content provide background or reference information that is useful for multiple tasks? If yes, find a place for your content in the Reference information section, and add a new Documentation Guide or Page there. (Examples of reference information: Understanding issue pages on drupal.org. Searching for issues. Issue summary templates. Git reference.)
  5. Does your content describe an area that people can contribute to, such as Documentation, Translations, or Accessibility? If yes, it is a Contribution Area. See the separate Guidelines for Contribution Areas page.
  6. Does your content fit into more than one of these categories? If yes, you need to divide it up into pieces, each of which fits the model for one of the content types.

Once you have decided which content item(s) to add, you should also search in the Role browser, Task browser, and Skill browser pages, check the menu in Contribution Areas, and look in the Reference information section, to make sure your content, or a closely-related content item, does not already exist. If it does, you can check to see if the existing pages are complete, and edit them to make them even better.

If your content does not already exist, please go ahead and create your new content and it will immediately be available for other contributors to use. The exception is Contribution Areas -- they are a bit more complex to create -- see the separate Guidelines for Contribution Areas page for steps.

Help improve this page

Page status: No known problems

You can: