Last updated January 10, 2012.
Updating and maintaining Drupal's documentation is an important project. For a new contributor, learning how how to contribute to the documentation can have a bit of a learning curve and often lots of questions arise in the process. This page attempts to provide an overview of those questions, with brief answers and links to more information.
As you can see, this page is currently itself a work in progress. ;) You are, naturally, encouraged to contribute.
I just want to suggest a one-off change to a page. How do I do that?
If you don't yet have an account on Drupal.org, create one. Then you can do one of several things, depending on your comfort level:
- Edit the page directly using the "Edit" tab (unless it is a locked page)
- If it is a locked page, create a new issue (which is like a ticket) in the Documentation project
- Leave a comment on the page itself, explaining the change to be made, and also edit the page to change the Page Status to something appropriate.
If you are trying to change API documentation, see "How do I change the API documentation?", below.
I'd like to contribute to documentation. How do I get involved?
There are several quick and simple ways you can help improve documentation. You can also check the list of current priorities, and we also have a longer how-to contribute to documentation guide available.
I've submitted a few issues about documentation and/or created or edited a few documentation pages, but I'd like to do more. What's next?
If you'd like to do more than the tasks above, you can help to close issues in the Documentation issue queue, contribute to the discussions on the Documentation group page, or volunteer to lead documentation initiatives.
We also have a list of simple tasks you can get started on.
I'm a new member of the documentation team and am eager to help out. What sort of things do I need to know?
As you edit others' work and add new work of your own, be sure to keep the Style guide in mind and follow what it says. Others who are doing the same thing as you will eventually find your page and try to bring it in line with the style guide, anyway.
For a much bigger overview of contributing to Drupal's documentation, read the rest of this Contributing to documentation section.
I found a page that is completely out of date, or redundant. How do I remove it?
Submit a new Documentation project issue so someone with permission to delete pages can review it. If you're unsure of how to use the issue tracking pages, see Documentation issue reports.
What are all these references to "d.o", "a.d.o", "g.d.o", etc. that I am seeing all over the place?
These are shorthand references to drupal.org, api.drupal.org, groups.drupal.org, etc. Other sites you may see referenced are qa.drupal.org and localize.drupal.org.
Some documentation isn't in the Community Documentation pages -- where is it?
Some kinds of documentation are kept in other locations:
- The API documentation for Drupal developers is auto-generated from files in git. To update the description of a file, function, topic, etc., see Updating API documentation.
- Embedded documentation is included with every Drupal installation.
How do I change the API documentation?
See Updating API documentation.
Can I upload larger images and get them automatically re-sized?
Drupal.org doesn't re-size images, so it is suggested that you resize images yourself before uploading. Read the Screenshots and uploading images doc for a guide.