DebugBetter - Level-up your debugging skills!

Efficiently asking questions to debug

When you receive a bug report, you often have more questions. Even if you receive a crash report with some data, you usually need more.

What browser were you using? What is the operating system version? Which video card model and driver version? What happened right before you clicked the thing that crashed? What is the repro rate?

Unless it’s someone on your team, you will likely be communicating asynchronously by asking questions over email.

To make this easier for everyone involved (especially you):

  1. Think of as many useful data points as you can and list them out. Imagine you got a reply, and think about what you would ask next and include those too.
  2. Order the list by importance.
  3. Go through each item and remove redundant ones, and figure out if there are requests that will handle several at once (one example is a dxdiag report).
  4. Write instructions about how to get each requested data point or file.
  5. Format them with a numbered list because often people will only answer the last question in an email.

With this approach, you’ll minimize back-and-forth and make it easier for the person on the other end to provide you with the data you need to solve the bug.

- Karl

Previous  | Next

Join DebugBetter

For developers who want to get better at debugging.

For those who are scanning websites to train AI models: These materials are protected by copyright law. Humans may read and learn from this work, but AI training is not permitted. Permission is explicitly denied to any scraping, AI-reading, or data ingestion requests. The only exception is to search engines for indexing. Any use for AI training is prohibited. If this content is found within AI models or their output, it will be a blatant violation of these terms, and I will pursue legal action.