Difference between revisions of "Bugs"
m (→Good examples) |
|||
| (21 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
== Why bother? == | == Why bother? == | ||
| − | * | + | *• This helps improve Odamex by making it more robust ; |
| − | * | + | *• This will help improve your bugfinding and testing skills ; |
| − | * You | + | *• You will get mentioned in the credits/contributors list if your report was very helpful (i.e. fixed a major problem). |
| + | |||
| + | == Bug Tester's Guide == | ||
| + | |||
| + | You can contribute to Odamex by finding new bugs and testing to see if existing bugs have been resolved. | ||
| + | |||
| + | === Resources === | ||
| + | |||
| + | There are several resources open to you: | ||
| + | |||
| + | * ► '''[http://odamex.net/bugs Bugzilla]''', | ||
| + | * ► Your '''[[debugger]]''', | ||
| + | * ► A guide to '''[[regression|regression testing]]''', | ||
| + | * ► Our '''[https://github.com/odamex/odamex Github]''' repository. | ||
| + | |||
| + | === Things to do === | ||
| + | If you are involved in testing, you should generally build Odamex in [[debug]] mode and run it from within a [[debugger]] to obtain helpful information. | ||
| + | |||
| + | ==== Known bugs ==== | ||
| + | If stuck for things to do, please browse through our bug list to see if any bug needs testing. This will usually become obvious if you read the bug comments. Test for the bug and post your own comments. Make sure you are running the latest Odamex code, from our [https://github.com/odamex/odamex Github] repository. | ||
| + | |||
| + | ==== New bugs ==== | ||
| + | Read and search the bug list before you post new bugs. Chances are, the bug has already been noticed by someone else. Bugs you should report commonly include [[incompatibilities]], [[vulnerability|vulnerabilities]] and [[crash|crashes]]. Also report any major annoyances, unintuitive, malfunctioning and missing features. Be reasonable in your assessment and always include exact instructions needed to reproduce the bug. | ||
== How to report a bug == | == How to report a bug == | ||
The [http://odamex.net/bugs Odamex Bug Tracker] is an active list of issues. Look through the bugs to see if the bug you want to report is already listed. Please only post reproducible bugs, with steps to reproduce them. | The [http://odamex.net/bugs Odamex Bug Tracker] is an active list of issues. Look through the bugs to see if the bug you want to report is already listed. Please only post reproducible bugs, with steps to reproduce them. | ||
| − | |||
| − | |||
== What to include == | == What to include == | ||
| − | For a [[crash]], be | + | For a [[crash]], the following information should be included in your report (or as much as you can): |
| + | *• [[Debugger]] information '''including the callstack''' | ||
| + | *• Steps to reproduce the crash (what you did to make it happen) | ||
| + | *• Other information including WAD files, map, operating system, compiler used and configuration (being server config, etc) | ||
| − | + | If the bug appears to be new and did not appear in a previous [[svn]] revision, it would also be helpful to determine which revision caused the bug. You may need to do [[regression]] testing to work this out and include the revision at which the bug was introduced. | |
| − | + | == Good examples == | |
| + | *• A textbook example is shown in {{Bug|163}} | ||
| + | *• A good report is provided by {{Bug|116}} | ||
Latest revision as of 15:35, 17 January 2019
Contents
Why bother?
- • This helps improve Odamex by making it more robust ;
- • This will help improve your bugfinding and testing skills ;
- • You will get mentioned in the credits/contributors list if your report was very helpful (i.e. fixed a major problem).
Bug Tester's Guide
You can contribute to Odamex by finding new bugs and testing to see if existing bugs have been resolved.
Resources
There are several resources open to you:
- ► Bugzilla,
- ► Your debugger,
- ► A guide to regression testing,
- ► Our Github repository.
Things to do
If you are involved in testing, you should generally build Odamex in debug mode and run it from within a debugger to obtain helpful information.
Known bugs
If stuck for things to do, please browse through our bug list to see if any bug needs testing. This will usually become obvious if you read the bug comments. Test for the bug and post your own comments. Make sure you are running the latest Odamex code, from our Github repository.
New bugs
Read and search the bug list before you post new bugs. Chances are, the bug has already been noticed by someone else. Bugs you should report commonly include incompatibilities, vulnerabilities and crashes. Also report any major annoyances, unintuitive, malfunctioning and missing features. Be reasonable in your assessment and always include exact instructions needed to reproduce the bug.
How to report a bug
The Odamex Bug Tracker is an active list of issues. Look through the bugs to see if the bug you want to report is already listed. Please only post reproducible bugs, with steps to reproduce them.
What to include
For a crash, the following information should be included in your report (or as much as you can):
- • Debugger information including the callstack
- • Steps to reproduce the crash (what you did to make it happen)
- • Other information including WAD files, map, operating system, compiler used and configuration (being server config, etc)
If the bug appears to be new and did not appear in a previous svn revision, it would also be helpful to determine which revision caused the bug. You may need to do regression testing to work this out and include the revision at which the bug was introduced.