Difference between revisions of "Bug Report Workflow (Support)"
Foxfirefey (Talk | contribs) m (Protected "Bug Report Workflow (Support)": Excessive spamming ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))) |
(Revamping because it's what I do.) |
||
| Line 1: | Line 1: | ||
{{Note|text=This is currently a proposed policy that is open to comment.}} | {{Note|text=This is currently a proposed policy that is open to comment.}} | ||
| − | Currently a significant number of support requests are related to site functionality, many of which may be actual bugs. Most bugs are known, but since this is such a common source of inquiries we need to be able to handle them quickly to keep our stress levels down and our users happy! With this in mind, follow these steps to ensure a consistent | + | Currently a significant number of support requests are related to site functionality, many of which may be actual bugs. Most bugs are known, but since this is such a common source of inquiries we need to be able to handle them quickly to keep our stress levels down and our users happy! With this in mind, follow these steps to ensure a consistent and timely approach. |
If you have ideas for improving this policy, add them to the Discussion Page or contact <dwuser>invisionary</dwuser> directly. (skrshawk on IRC) | If you have ideas for improving this policy, add them to the Discussion Page or contact <dwuser>invisionary</dwuser> directly. (skrshawk on IRC) | ||
| Line 7: | Line 7: | ||
= Bug Workflow = | = Bug Workflow = | ||
| − | + | == Is it known? == | |
| − | + | When a bug report comes in, check to see if it's known already. The best way to do this is to search [http://bugs.dwscoalition.org/ Bugzilla]. Put important words into the search. Also ask around IRC - people can often point to common bugs off the top of their heads. | |
| − | + | If the bug is a known issue, reply to the user letting them know. Use appropriate soft skills, especially if the issue has resulted in frustration or data loss. Per <dwuser>mark</dwuser>, ''don't'' give links to the Bugzilla entry! A good description of what we have on file will suffice. | |
| + | |||
| + | == Confirm the bug steps == | ||
| + | |||
| + | If the issue is not an obvious bug, get confirmation of the steps that the user is taking to get the problem. It's possible that the issue is user error, but that doesn't mean there's no bug! You may find that a user has inadvertently stumbled on a way to make the service better, in which case you will want to file an enhancement request. Great ideas come from everyday users. | ||
Make sure you understand what the user is trying to do - don't be afraid to ask questions! Emphasize that you are trying to get a clear understanding, while doing your best to not talk down to the user. It takes baby steps sometimes to get to the root of a problem; don't be afraid to share that with someone! Important information to get: | Make sure you understand what the user is trying to do - don't be afraid to ask questions! Emphasize that you are trying to get a clear understanding, while doing your best to not talk down to the user. It takes baby steps sometimes to get to the root of a problem; don't be afraid to share that with someone! Important information to get: | ||
| − | * Operating | + | * Operating system and browser, versions if possible. |
* Exactly what the user is doing, step by step. | * Exactly what the user is doing, step by step. | ||
| − | * What the user expects to happen as a result of their steps and what actually happened | + | * What the user expects to happen as a result of their steps and what actually happened. |
| − | * Any error messages, copy/pasted | + | * Any error messages, copy/pasted. |
If you've found the problem was based on what the user was doing give them steps to correct it - nicely, of course. If through their work you've discovered a way to improve the service, continue with the bug report process! | If you've found the problem was based on what the user was doing give them steps to correct it - nicely, of course. If through their work you've discovered a way to improve the service, continue with the bug report process! | ||
| − | + | == File a bug! == | |
| + | |||
| + | If you need to file a bug, you can follow the instructions for bug reporting (anyone is welcome to file a bug!), or you can hand this off to a senior support person if you'd prefer. Do as much of the process as you're comfortable with and ask questions along the way. Try to get someone else to verify the bug and the steps to reproduce it if possible. If you can't reproduce it (or you can but someone else can't) make a note of this in your report. | ||
| − | + | '''IMPORTANT:''' If the user is reporting a security-related bug in the main support queue, ''don't touch it''! Alert a senior support person, who will transfer the request to an appropriate private queue. We need to keep these things out of the public eye, so if you spot a miscategorized report, tell us immediately! This also applies to Abuse/ToS related support requests. | |
= Bugzilla Reporting Workflow = | = Bugzilla Reporting Workflow = | ||
| − | The entire Bugzilla workflow (which goes from bug reporting to committed patch) can be found | + | The entire Bugzilla workflow (which goes from bug reporting to committed patch) can be found [http://wiki.dwscoalition.org/notes/Bugzilla_workflow here]. The full article is good reading so you have an understanding of the entire development process. Here is a simplified version focusing on bug reporting. If you'd rather follow the primary document, the first three steps are what you need to know. Otherwise, read on. |
1. To log a bug you will need a Bugzilla account. Anyone can make one, so follow the simple process. You don't need an account to search and view bugs, however. Go here to create your account: http://bugs.dwscoalition.org/createaccount.cgi | 1. To log a bug you will need a Bugzilla account. Anyone can make one, so follow the simple process. You don't need an account to search and view bugs, however. Go here to create your account: http://bugs.dwscoalition.org/createaccount.cgi | ||
| Line 34: | Line 40: | ||
2. Create the bug here: http://bugs.dwscoalition.org/enter_bug.cgi. | 2. Create the bug here: http://bugs.dwscoalition.org/enter_bug.cgi. | ||
| − | Select a queue for your bug. Generally you're going to want the Dreamwidth Development queue. If the bug is related to something that needs to be better clarified in the FAQs or elsewhere in the site copy, use the Project Documentation queue. | + | Select a queue for your bug. Generally you're going to want the Dreamwidth Development queue. If the bug is related to something that needs to be better clarified in the FAQs or elsewhere in the site copy, use the Project Documentation queue. |
| − | + | 3. The next screen is the main bug entry page. Fill in the following fields: | |
| − | < | + | {|class="wikitable" |
| + | |-valign="top" | ||
| + | | '''Component''' | ||
| + | | Most of the time UI/Frontend is the nature of the bug, but use other options as appropriate. | ||
| + | |-valign="top" | ||
| + | | '''CC''' | ||
| + | | Add your email here if you want to track progress of the bug. | ||
| + | |-valign="top" | ||
| + | | '''URL''' | ||
| + | | The page (if appropriate) where the bug is happening. | ||
| + | |-valign="top" | ||
| + | | '''Summary/<br>Description''' | ||
| + | | Fill these in with as many details as you can. You should have plenty from your interaction with the user and other support people. | ||
| + | |-valign="top" | ||
| + | | '''Severity''' | ||
| + | | Most likely the highest severity you'll need to use is Minor, which is what you want if you suspect a bug affect a significant number of users. Any higher than that should be significantly affecting site usability - if so, talk to a senior about it, or check with IRC. | ||
| + | |-valign="top" | ||
| + | | '''Priority''' | ||
| + | | Stick with P4 or P5. If you suspect a bug warrants a higher priority, again, talk to a senior support member, or mention it in IRC. | ||
| + | |-valign="top" | ||
| + | | '''Tags''' | ||
| + | | Use the existing tag list. The tags are intuitive; use what's most appropriate. | ||
| + | |-valign="top" | ||
| + | | '''Flags''' | ||
| + | | You may wish to use <code>need-spec</code> or <code>needs-design</code> for enhancements that aren't fully fleshed out. Spec is for enhancements that need thought as to just what should be done; Design is for enhancements that might need thought put into the visual/frontend elements. Set either to ? as appropriate. | ||
| + | |} | ||
3. Hit the commit button and watch it go into the queue (and Bugsy report it in #dw!). Be prepared to field further questions from the devs if needed - don't worry, we don't bite unless asked nicely! | 3. Hit the commit button and watch it go into the queue (and Bugsy report it in #dw!). Be prepared to field further questions from the devs if needed - don't worry, we don't bite unless asked nicely! | ||
Revision as of 16:47, 4 July 2013
Currently a significant number of support requests are related to site functionality, many of which may be actual bugs. Most bugs are known, but since this is such a common source of inquiries we need to be able to handle them quickly to keep our stress levels down and our users happy! With this in mind, follow these steps to ensure a consistent and timely approach.
If you have ideas for improving this policy, add them to the Discussion Page or contact ![[info]](http://wiki.dreamwidth.net/wiki/extensions/LJ/images//dw/user.png){kind=small}
invisionary directly. (skrshawk on IRC)
Contents
Bug Workflow
Is it known?
When a bug report comes in, check to see if it's known already. The best way to do this is to search Bugzilla. Put important words into the search. Also ask around IRC - people can often point to common bugs off the top of their heads.
If the bug is a known issue, reply to the user letting them know. Use appropriate soft skills, especially if the issue has resulted in frustration or data loss. Per mark, don't give links to the Bugzilla entry! A good description of what we have on file will suffice.
Confirm the bug steps
If the issue is not an obvious bug, get confirmation of the steps that the user is taking to get the problem. It's possible that the issue is user error, but that doesn't mean there's no bug! You may find that a user has inadvertently stumbled on a way to make the service better, in which case you will want to file an enhancement request. Great ideas come from everyday users.
Make sure you understand what the user is trying to do - don't be afraid to ask questions! Emphasize that you are trying to get a clear understanding, while doing your best to not talk down to the user. It takes baby steps sometimes to get to the root of a problem; don't be afraid to share that with someone! Important information to get:
- Operating system and browser, versions if possible.
- Exactly what the user is doing, step by step.
- What the user expects to happen as a result of their steps and what actually happened.
- Any error messages, copy/pasted.
If you've found the problem was based on what the user was doing give them steps to correct it - nicely, of course. If through their work you've discovered a way to improve the service, continue with the bug report process!
File a bug!
If you need to file a bug, you can follow the instructions for bug reporting (anyone is welcome to file a bug!), or you can hand this off to a senior support person if you'd prefer. Do as much of the process as you're comfortable with and ask questions along the way. Try to get someone else to verify the bug and the steps to reproduce it if possible. If you can't reproduce it (or you can but someone else can't) make a note of this in your report.
IMPORTANT: If the user is reporting a security-related bug in the main support queue, don't touch it! Alert a senior support person, who will transfer the request to an appropriate private queue. We need to keep these things out of the public eye, so if you spot a miscategorized report, tell us immediately! This also applies to Abuse/ToS related support requests.
Bugzilla Reporting Workflow
The entire Bugzilla workflow (which goes from bug reporting to committed patch) can be found here. The full article is good reading so you have an understanding of the entire development process. Here is a simplified version focusing on bug reporting. If you'd rather follow the primary document, the first three steps are what you need to know. Otherwise, read on.
1. To log a bug you will need a Bugzilla account. Anyone can make one, so follow the simple process. You don't need an account to search and view bugs, however. Go here to create your account: http://bugs.dwscoalition.org/createaccount.cgi
2. Create the bug here: http://bugs.dwscoalition.org/enter_bug.cgi.
Select a queue for your bug. Generally you're going to want the Dreamwidth Development queue. If the bug is related to something that needs to be better clarified in the FAQs or elsewhere in the site copy, use the Project Documentation queue.
3. The next screen is the main bug entry page. Fill in the following fields:
| Component | Most of the time UI/Frontend is the nature of the bug, but use other options as appropriate. |
| CC | Add your email here if you want to track progress of the bug. |
| URL | The page (if appropriate) where the bug is happening. |
| Summary/ Description |
Fill these in with as many details as you can. You should have plenty from your interaction with the user and other support people. |
| Severity | Most likely the highest severity you'll need to use is Minor, which is what you want if you suspect a bug affect a significant number of users. Any higher than that should be significantly affecting site usability - if so, talk to a senior about it, or check with IRC. |
| Priority | Stick with P4 or P5. If you suspect a bug warrants a higher priority, again, talk to a senior support member, or mention it in IRC. |
| Tags | Use the existing tag list. The tags are intuitive; use what's most appropriate. |
| Flags | You may wish to use need-spec or needs-design for enhancements that aren't fully fleshed out. Spec is for enhancements that need thought as to just what should be done; Design is for enhancements that might need thought put into the visual/frontend elements. Set either to ? as appropriate.
|
3. Hit the commit button and watch it go into the queue (and Bugsy report it in #dw!). Be prepared to field further questions from the devs if needed - don't worry, we don't bite unless asked nicely!
