Last updated 3 January 2017.
The Drupal community uses the issue queue to work as a team. If you need help with a specific project, whether a module or a theme, you should go to the issue queue where the maintainers, active users, and fans of the module or theme will be communicating for that specific project which makes it more likely that your question will be seen by people who can help you.
Additionally, you can also use the issue queue to report bugs and problems; see the Reporting problems section of this guide for more information.
What is the issue queue?
Each project, whether a theme or a module, has its own "issue queue" which is a listing of categorized posts connected to that project and are summarized on the sidebar content of that project's page.
The issue queue allows any project user to post an 'issue' to a specific project version and categorize it (e.g., bug report, feature request) and suggest a priority such as 'critical' or 'normal'. Subsequently, the project maintainer assigns tasks to colleagues, and tracks the status (e.g., active, fixed). In this way, concerns related to a specific project can be more efficiently tracked.
Each project also has components (e.g., documentation, code). Some projects have additional components; for example, the Drupal core project has the "taxonomy.module" component and "user system" component. The list of issue components used on a specific project is set by that project's maintainer. Use the "Advanced search" option or use the drop down menus to see specific components and/or filter them.
Here is a short video that gives an overview of how to use the issue queues. You may also be interested in this screencast on how to use the Drupal issue queues to contribute to Drupal.
How to get notifications of new issues on a project
If you are an avid user of a project you should subscribe to the issue queue in one of two ways:
- Via email: From the project's page (e.g., http://drupal.org/project/[project-name]) you can see a block in the right sidebar titled "Issues for [project name]" and under that is a link to "Subscribe via e-mail". This will send email notifications when someone posts an issue to that project's queue.
- Via RSS: From the issue queue for a project, scroll to the bottom of the page and next to the "Subscribe with RSS" click on the RSS feed button to receive the project's queue.
To subscribe to a specific issue, just click the "Follow" link in the top right corner, and you will see the issue on your "My issues" page. To unsubscribe, just click it again (it will say "Following" if you are subscribed, and hover to say "Unfollow").
To search the issue queue for a specific project, you can search directly from the project page, with the search form "Issues for [project name]". Click Advanced Search or use the drop down menus for additional options to filter for status and category, version or components, etc.
Issue queue care & maintenance
Maintaining an issue queue requires a serious commitment. Maintenance tasks include:
- Verifying bugs are still bugs
- Marking duplicate issues
- Answering support requests
- Responding to issues in a number of constructive ways
- Creating and Rolling patches
See the Views Bug Squad's How to work the issue queue tutorial as a starter guide to maintaining an issue queue.
Project maintainers should visit: Start or Maintain Modules, Themes, Installation Profiles or Translations for details on how to be a good project maintainer.
Even if you are not a maintainer, you can give considerable help on the issue queue. See How to help maintainers in the issue queues.
However, as a maintainer, you can organize your own team around your project. A good example is the Views Bug Squad. This is a good way for other developers to get mentoring in project maintenance.
Note: The issue queue is made possible by a Drupal module, too. If you are interested in the issue queue's code to use on your own site, see the Project issue tracking module and the Project module. And if you have ideas about how to make these modules better, please contribute!