How to Write a Good Bug Report

  • Hey guys,

    Once again, welcome to the Bug Report Forums! I am very excited to work with all of you.

    I wanted to touch base with you on what I am looking for in bug reports. Please read through this guide as it explains some Do's and Don't's for bug testing and reporting.

    Alright, let's get started:

    Ground Rules

      Feedback is NOT a bug. Anything related to feedback, class balance, boss suggestions, etc. belongs in another forum.I read every single thread that is posted on the forums. However, I will not always respond to them. Please DO NOT bump posts. I will ignore and possibly delete any post that simply says "bump" or calls out for a Blizzard poster.When reporting a bug, please make a thread for each bug you find. Threads that contain multiple bugs are difficult to manage, especially if I am unable to reproduce any of them on my end.Please use the Search feature to search the forum and see what bugs are post. If you have a duplicate thread, I will lock it and point you to the current thread where the bug is being discussed.Finally, please only discuss bugs within the threads. Avoid completely off topic discussions or other things not related to the bug in the thread.

    Bug Writing

    Ok, you found a bug--congratulations! But now what? This guide will explain how to accurately write a bug report.

      When posting a bug, please include a summary that attempts to accurately describe the bug. I should be able to understand at least 75% of the issue you are reporting simply by looking at your summary. I understand that the size of the summary has to be short, but please do your best.
        Good summary: Tooltip for the skill Bash has a typoBad summary: Bug with smash skill
      After your summary, include a brief description of the bug you experienced. Include as much RELEVANT information as you can. Where you in multiplayer? Could you reproduce the issue? I need to know this stuff.If you have steps and can reproduce your issue consistently, write them out. This will help Quality Assurance get a must faster turn around time reproducing the issue and reporting it to the Diablo III designers.Finally, it always helps to attach a link to Photobucket (or another picture hosting site) that displays a screenshot of the bug. If you need to include a video, link to a video as well.

    Types of Bugs

    Below are some different types of bugs you will encounter in Diablo III. I have also included the specific information I would like for each bug reported of this type.

    Combat bugs - These are pretty simple. If there is a broken skill in the game, include the name of the skill and the class that uses the skill.
      Example: The Barbarian's skill Bash does not knock enemies away.

    Quest bugs - These can be complicated. For them, I ask that you include two things. The first is the name of the quest and quest step that you were on during the quest. The name of the quest is the name that displays at the top of your quest log, while the quest step is the specific instructions for you to complete in the quest.The second thing I ask is if this happened in multiplayer or solo play.
      Example: During the quest "The Fire From The Sky : Slay a Wretched Mother", you cannot kill the Wretched Mother in multiplayer.

    Environment bugs - Finally, Environment bugs round out the specific types of bugs I need more information about. For Environment bugs, please describe the issue you and tell me where it is located. The level area you are in can be found above the minimap. Every location in the game has a level area, and it helps to know this before I start looking.

    Screenshots are perfect for Environment bugs as well. They will accurately display the issue you are seeing. Screenshots can be taken by pressing Print Screen and can be found in the Screenshots folder on My Documents/Diablo III. Uploading a screenshot to an online photo site like Imgur and linking it back to your thread would help me a lot as well.
      Example: In New Tristram, one of the houses is bright pink.


    Crashes are getting their own section because of their complexity. One major way you can help Blizzard out is by filling out the crash box that appears if you crash. Simply write a description of what happened when you crashed. Were you in multiplayer? Were you fighting a specific boss? Also, please copy down the Crash ID before pressing Re-Open and submitting the crash. This Crash ID can be given to Customer Service so they can look up your crash.

    Again, welcome to Diablo III! Following these guidelines will allow all of us to work together as efficiently as possible. Thanks for reading and enjoy the game!