Fork us on GitHub Follow us on Facebook Follow us on Twitter

Changes between Version 4 and Version 5 of HowToFileABug


Ignore:
Timestamp:
2010-07-27T20:55:07Z (12 years ago)
Author:
Jakub Jermář
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • HowToFileABug

    v4 v5  
    33As in any other complex software system, there will inevitably be bugs in the HelenOS source code (unless we can formally prove the opposite). It is therefore essential for people who run into them to make sure the bug is actually known to the developers and that all potentially relevant information that can help to root-cause the bug is available. This is best achieved by filing a ticket in our bug tracking database.
    44
    5 Below follows a list of tips for filing the most useful bug reports, but before filing one, please check the existing tickets to see whether the problem you are going to log is a new bug or a duplicate of an already known issue. For duplicates, you can try to improve the original bug report by providing additional information. For new bugs, continue with the following points.
     5Writing bug reports is by far not that trivial as it may initially seem. Quite the contrary. Writing really good bug reports takes some effort and needs some practice, but the reward is high.  The ticket owner can then focus on solving the bug itself rather than figuring out all the information and circumstances that lead to the it. Below follows a list of tips for filing the most useful bug reports.
    66
     7  * Make sure the bug is not a duplicate of some other bug
     8    * If it is, consider improving the original bug report, but don't file any new ticket
    79  * Pick a descriptive ```Summary```
    810    * '''bad''': ''HelenOS has bugs''
     
    2325      * name and version of the simulator/virtualizer, if the target system is a simulated machine
    2426    * Provide reasonable details about HelenOS configurations
    25       * consider including Makefile.config from the root of the HelenOS tree
     27      * consider attaching Makefile.config from the root of the HelenOS tree
    2628    * If there is a stack trace associated with the bug, paste it into the bug report
    2729      * In case there is a core dump generated for a crashing task, compress it and attach it to the ticket
    28       * Alternatively, attach the compressed binary itself (kernel.raw or the respective uspace binary). Note that attaching .disasm files is problematic as these files are usually much bigger than the respective binaries themselves.
     30      * Alternatively, attach the compressed binary itself (kernel.raw or the respective uspace binary). Note that attaching .disasm files is problematic as these files are usually much bigger than the respective binaries themselves (even when compressed).
    2931    * If there are some terminal or console messages of interest such as warnings or errors, mention those in the bug report.