Triage, the process of reviewing incoming bug tickets, gathering more information about the situation, and verifying whether or not the report is valid, is a critical part of the day-to-day operation of all of our projects. Some new tickets are valuable reports of broken behavior, others are suggestions for enhancements both large and small, and some are, in fact, not bugs at all. Identifying which issues are which and facilitating timely communication between the reporter and the contributors whose input is necessary to resolve the problem are all parts of the triage process.
For a newcomer, triage is a natural way to find the pulse of a project and see what other contributors will be thinking about on any given day (because they're also helping with triage), as well as interacting with the team and making yourself part of the process! It's also a good way to increase the breadth of your exposure to a particular project; the process of verifying bugs will encourage in-depth looks at parts of code and functionality with which you weren't already familiar. And if you're hoping to eventually contribute code, helping with triage is a great way to identify the bugs that need to be fixed and observe how others go about solving similar problems.
How Do I Help?
You can help with triage for as many or as few projects as you're interested in. The process is relatively similar for all of them:
- Figure out a way that works for you to get a steady stream of new issues.
- When new issues are reported, reply politely with an appropriate response based on the situation. You may need to ask for more information, a simplified test case (or a test case at all), duplicate the reported behavior using a provided test case (or reducing one further), or direct the reporter to the right venue for their issue.
- Participate in the discussion as it continues, as necessary.
Here's how to accomplish Step 1 above for each of our projects:
jQuery Core and jQuery UI
jQuery Core and UI both use Trac, an open source standalone bug tracking system.
Trac does not require you to have an account to report bugs, but you'll definitely want to register an account and log in with it. (Separate registrations are required for the two bug trackers.) Having an account helps everyone in the discussion keep track of who else is participating, and it's very difficult to keep in touch with "anonymous."
You can keep up to date with new bugs as they are reported by visiting the timeline on each site, but we recommend signing up to receive e-mail notifications when new bugs are reported and receive new comments. Most of the regular triagers use e-mail notifications to stay on top of things as they happen, as it tends to make it easier to digest activity on the tracker since the last time you checked. You can set up your e-mail preferences on the subscriptions tab of your Trac preferences. We also reccomend setting up a rule in your e-mail client to keep bug e-mails relatively self-contained.
jQuery Mobile, API Documentation, and Web Sites
For the most part, the rest of our projects keep track of bugs using GitHub issues. All you have to do is sign up for a GitHub account if you don't already have one. From there on out, it's as simple as "watching" the repositories you want to help triage. New issues and comments will make their way to your notification center and inbox, depending on your notification settings.
- jQuery Core API issues
- jQuery UI API issues
- jQuery Mobile API issues
- QUnit API issues
- jQuery Learning Site issues
- jquery-wp-content issues - The WordPress configuration and themes that serve all our sites
- jquery.com issues - The content of jquery.com itself
- plugins.jquery.com issues - The jQuery Plugin Registry
- jqueryui.com issues - The content of jqueryui.com itself
- download.jqueryui.com issues - The jQuery UI Download Builder
- jquerymobile.com issues - The content of jquerymobile.com itself
- qunitjs.com issues - The content of qunitjs.com itself
- sizzlejs.com issues - The content of sizzlejs.com itself
- jquery.org issues - The content of jquery.org itself
- contribute.jquery.org issues - The content of the jQuery Contribution Hub site
- events.jquery.org issues - The content of our Events and Conferences site
- irc.jquery.org issues - The content of our IRC log and information site
- bugs.jquery.com issues - Issues with jQuery Core's Trac itself
- bugs.jqueryui.com issues - Issues with jQuery UI's Trac itself