Difference between revisions of "Bug Report Workflow (Support)"

From Dreamwidth Notes
Jump to: navigation, search
(Github Issues Reporting Workflow)
(Github Issues Reporting Workflow)
Line 38: Line 38:
  
  
# You will need a Github account to file a bug, although you can probably search the issues without one.  
+
# You will need a Github account to file a bug, although you can read the issues without one.  
# Link to create the issue goes here.  
+
# [https://github.com/dreamwidth/dw-free/issues Look over the existing issues], then use the Create Issue button if you don't see it already.  
# Description of the minimum amount of information to create the bug goes here. Commentary on documentation process if different.  
+
# Enter a title (brief summary) and comment (more in-depth description).
# How to submit. Don't be afraid that you've left out something important. If devs need further information, they will ask; in accordance with your Github settings, you should be notified.  
+
# Use the "Submit New Issue" button to submit. Don't be afraid that you've left out something important. If devs need further information, they will ask; in accordance with your Github settings, you should be notified.  
  
 
[[Category:Support]]
 
[[Category:Support]]
 
[[Category:Brainstorming]]
 
[[Category:Brainstorming]]
 
[[Category:Development]]
 
[[Category:Development]]

Revision as of 23:13, 2 August 2014

Note: This currently requires update to match current practice, full swapover to GHI, and update from Support leads on current practice.


Bug Workflow

Is it known?

When a bug report comes in, check to see if it's known already. Dreamwidth has moved from Bugzilla to Github Issues. You can also ask around Support areas to see if anyone else is aware of whether it's filed (or was filed in Bugzilla).

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 [info]mark, don't give links to the Github Issues 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.

Github Issues Reporting Workflow

The entire Github Issues workflow (which goes from bug reporting to live on site) will be found at the Github Issues page. This page will be updated at some point when it's finalized.


A general overview:


  1. You will need a Github account to file a bug, although you can read the issues without one.
  2. Look over the existing issues, then use the Create Issue button if you don't see it already.
  3. Enter a title (brief summary) and comment (more in-depth description).
  4. Use the "Submit New Issue" button to submit. Don't be afraid that you've left out something important. If devs need further information, they will ask; in accordance with your Github settings, you should be notified.