 |
|
[READ BEFORE POSTING] Reporting bugs: Howto
|
|
Date: 2006/08/26 16:35
|
By: beat
|
Status: Admin
|
|
|
Karma: 238
|
|
Admin
| Posts: 3995 |   |
|
|
How to report bugs effectively...saw today this excellent summary of a long article:
Summary from Simon Tatham, professional and free-software programmer:
Summary
- 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.
- 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.
- When your computer does something unexpected, freeze. Do nothing until you're calm, and don't do anything that you think might be dangerous.
- 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.
- 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.
- Write clearly. Say what you mean, and make sure it can't be misinterpreted.
- 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  - Developer on Community Builder core Team
- If you like CB and this forum, you will love Nick's CB 1.1 reference manual !  : Click here to Get it now
- Would like to help us move faster ? Get it, and/or help us spend more time coding by helping others in this forum, many thanks
|
|
The topic has been locked. |
|
|
