[READ BEFORE POSTING] Reporting bugs: Howto

17 years 7 months ago #19649 by beat
How to report bugs effectively...saw today this excellent summary of a long article:

Summary from Simon Tatham, professional and free-software programmer:

  1. The first aim of a bug report is to let the programmer see the failure with their own eyes. If you can't be with them to make it fail in front of them, give them detailed instructions so that they can make it fail for themselves.
  2. In case the first aim doesn't succeed, and the programmer can't see it failing themselves, the second aim of a bug report is to describe what went wrong. Describe everything in detail. State what you saw, and also state what you expected to see. Write down the error messages, especially if they have numbers in.
  3. When your computer does something unexpected, freeze. Do nothing until you're calm, and don't do anything that you think might be dangerous.
  4. By all means try to diagnose the fault yourself if you think you can, but if you do, you should still report the symptoms as well.
  5. Be ready to provide extra information if the programmer needs it. If they didn't need it, they wouldn't be asking for it. They aren't being deliberately awkward. Have version numbers at your fingertips, because they will probably be needed.
  6. Write clearly. Say what you mean, and make sure it can't be misinterpreted.
  7. Above all, be precise. Programmers like precision.

Post edited by: beat, at: 2006/12/15 14:38

Post edited by: beat, at: 2007/10/03 10:30

Beat - Community Builder Team Member

Before posting on forums: Read FAQ thoroughly -- Help us spend more time coding by helping others in this forum, many thanks :)
CB links: Our membership - CBSubs - Templates - Hosting - Forge - Send me a Private Message (PM) only for private/confidential info
The topic has been locked.
Moderators: beatnantkrileon
Time to create page: 0.211 seconds

Facebook Twitter LinkedIn