Difference between revisions of "File Bugs"

From ReactOS Wiki
Jump to: navigation, search
(de-bloat)
m (Add missing closing parenthesis.)
(21 intermediate revisions by 8 users not shown)
Line 1: Line 1:
−
This article describes how to file bugs in our [http://reactos.org/bugzilla Bugzilla] Bug-Tracking Software. Bugzilla is used to gather information about failing or misbehaving components and allows to coordinate bug fixing efforts.
+
In September 2012, Bugzilla was replaced by [https://jira.reactos.org/ JIRA]. You can log in using your ReactOS website credentials. Several fields are the same as before, if you have questions regarding filing bugs, please use forum.
  
−
== First steps when encountering a bug ==
+
== Procedure ==
−
If you think you found a bug in ReactOS please ensure the following:
 
  
−
# Make sure you can replicate it. Restart ReactOS and try again to make sure.
+
This page describes how to file bugs in our JIRA Bug-Tracking Software. JIRA is used in this project to gather information about failing or misbehaving components and allows us to coordinate bug fixing efforts.
−
# Check that it hasn't been reported already. The bugzilla search will help you.
 
−
# Make sure you are testing a recent and official ReactOS build. New nighly builds (preferred testing source) can be obtained [http://www.reactos.org/getbuilds/ here].
 
−
# If you are running ReactOS on [[virtualization software|emulator]], please mind that we officially support [[QEMU]], [[VMware]] and [[VirtualBox]]. Others are not supported and your bug may not be valid.
 
  
−
If those points are valid for your bug you most likely found an important bug. But certain types of bugs are out of the scope of the project, so make sure the follows section applies as well.
+
=== First Steps ===
  
−
== Bugs to not report in the ReactOS Bugzilla ==
+
If you think you found a bug in ReactOS:
−
* Build breakages on the common platforms (Windows, Linux). Please report build breakages on IRC, or to the [http://www.reactos.org/?page=community_mailinglists ros-dev mailing list].
 
−
* Features reported to be in the next version of Windows (WinFS, etc..)
 
−
* Bugs in external components (Freetype, Wine, Mesa etc.). Please use the other projects bug trackers for this purpose.
 
  
−
== Information to include ==
+
* Make sure you can replicate your bug. Restart ReactOS and try again to make sure.
  
−
# Choose a concise bug title
+
* Check that it hasn't been reported already. The JIRA search will help you confirm this.
−
# Include steps how to reproduce the bug
 
−
# Tell us your hardware or virtual machine configuration
 
−
# Include the ReactOS version you tested (open up a commandline and type 'ver' in case you are unsure)
 
−
# In case the bug is related to an external application make sure you include the version number
 
−
# Add a screenshot in case it's a graphical bug (a picture is worth a 1000 words), attach it to bugzilla instead of using external hosting services
 
−
# Provide a debug log, especially in case of crashes, freezes and application errors. See [[Debugging]] on how to obtain high quality debug output
 
  
−
== Additional Information ==
+
* Make sure you are testing a recent and official ReactOS build. New nightly builds (preferred testing source) can be obtained [https://www.reactos.org/getbuilds/ here].
−
If you have any questions or problems regarding reporting bugs, please consult amine48rz, Caemyr or gabriel_it on IRC.
 
  
−
* Try not to paste the debug log directly into the bug report, attach it instead. It helps readability.
+
* If you are running ReactOS on a virtual machine, please mind that we support [[QEMU]], [[VMware]] and [[VirtualBox]]. Others are not supported.
  
−
* Use Bugzilla as a way to file bugs, not to ask for support or discuss other things not related to the bug, again readability is essential.
+
Since certain bug types are out of the scope of the project, please:
  
−
* The bug report should cover a single problem or case, no matter if it happens in multiple applications or has multiple ways of replicating it.
+
* Do not report build breakages on common platforms (Windows, Linux). Please report these on IRC or to the [https://www.reactos.org/community/mailing-lists mailing list].
  
−
* When bug was fixed but it uncovered another bug in the same application, you can reuse the previous bugreport, provided that you change the topic so it covers the new issue.
+
* Do not report features announced for the next version of Windows (WinFS, etc.).
  
−
* Do not post more than one issue in a single bug report.
+
* Do not report bugs in external components (Freetype, Wine, Mesa, etc.). Please use the other project's bug trackers for this purpose.
  
−
* Bugs that do not follow the guidelines will be closed as '''INVALID''' and the reporter will be asked to report the bug properly.
+
=== Important Information to Include ===
  
−
=== Using Bugzilla ===
+
To make sure we can reproduce and fix your bug, certain information has to be present. Important data you should include in your report includes:
−
To use the [http://reactos.org/bugzilla Bugzilla], you need to [http://www.reactos.org/roscms/index.php/register/ create] a myReactOS account on the ReactOS.org site, which will allow access to Bugzilla.
 
  
−
The Bugzilla form is pretty straight-forward, but here are some tips:
+
* Reproduction method using ''step by step'' instructions.
−
* '''Version''': If you are using a release, please indicate the version you are using. If you are using a build from SVN that is newer than the latest release, please use the version "TRUNK"
 
−
* '''Component''': This is the "area" of ReactOS where the bug is located. The [http://www.reactos.com/bugzilla/describecomponents.cgi?product=ReactOS Component] link next to the select box explains each component. If unsure, please guess, we can change it later.
 
−
* '''Platform''': Please note on what type of hardware you experienced this bug.  If unsure, use the default "x86 Hardware"
 
−
* '''OS''': The OS on which the bug happened. Usually will be "ReactOS", but if you were testing ReactOS components on Windows, please indicate which version.
 
−
* '''Severity''':  This indicates how "bad" the bug is. For most bugs, please leave this at "normal", we will adjust the severity as needed. Please do not file bugs as "blocker".  The Testing Coordinator or Developers will determine if a bug is a blocker. Please see [http://www.reactos.org/bugzilla/page.cgi?id=fields.html#bug_severity ReactOS Bugzilla Severities] for more information.
 
−
* '''Assigned To''': This will be filled automatically, when you choose a ''Component''.
 
−
* '''URL''': If this bug is against the "Online Services" component, please give the URL of the problem page.
 
−
* '''Summary''': A short description of the bug. When doing a bug listing, this is the only bug description shown. Please make this as clear as possible, since other users reporting bugs will need to check if a bug has already been filed.
 
−
* '''Description''': The detailed description of the bug, please place all the information you have gathered (above).
 
−
* '''Depends On''': Bugs that need to be fixed, before the reported bug can be fixed.  We will generally fill this in when needed.
 
−
* '''Blocks''': The reported bug needs to be fixed in order to fix these bugs. We will fill this in as needed.
 
−
* '''Add an Attachment''': This button can be used to attach files (debug logs, screenshots, patches) to the bug.
 
  
−
=== Some notes about Bugzilla ===
+
* Hardware or virtual machine configuration.
−
* After a bug is filed, or anytime it is updated, an email is sent to the [http://www.reactos.org/mailman/listinfo/ros-bugs ros-bugs mailing list]  
+
 
−
* The words "attachment" and "bug" are automatically linked in the description text. So if you say "This may be related to bug 1234", "bug 1234" will automatically become a link to bug 1234. "bug 1234 comment 2" will link to bug 1234 and go straight to comment 2.
+
* Tested ReactOS version (verify also that it does happen on [https://www.reactos.org/getbuilds/ nightly builds]).
−
* You could modify the wrong bug because of a "feature" in Bugzilla. After modifying a bug, Bugzilla takes you to the next bug in your list, so if you wanted to add something you forgot in your previous comment, you'd be updating another bug. Please check your preferences in Bugzilla: General preferences -> "After changing a bug" set it to "show the updated bug" and hit submit changes.
+
 
−
* You can use the Deskzilla program with the ReactOS Bugzilla, for more information consult the [[Deskzilla]] page.  
+
* The version of the application tested (if any) and a download link (URL).
 +
 
 +
* Screenshot of the problem if it's a graphical bug (add the attachment in JIRA).
 +
 
 +
* Debug log for crashes, freezes and application errors. See [[Debugging]] to see how to obtain a high quality debug output.
 +
 
 +
=== Reporting Guidelines ===
 +
 
 +
To ease bug reporting and fixing, please follow these guidelines:
 +
 
 +
* Choose a concise bug title.
 +
 
 +
* Attach the debug log file to the bug report, instead of pasting it in.  This improves the report's readability.
 +
 
 +
* Attach pictures to JIRA directly instead of using external hosting services.
 +
 
 +
* Use JIRA to file bugs, not to ask for support or discuss things not related to the bug.
 +
 
 +
* Cover a single problem in the bug report, even if it happens in multiple applications or can be replicated in multiple ways.
 +
 
 +
* Post only one issue in a single bug report.
 +
 
 +
Reports that violate these guidelines will be closed as invalid and the reporter will be asked to report the bug properly.
 +
 
 +
If any questions or problems regarding the bug reporting process arise, consult AmineKhaldi, Caemyr or gabriel_it(gone) on IRC.
  
 
[[Category:Testing]]
 
[[Category:Testing]]
 +
[[Category:Tutorial]]

Revision as of 10:30, 13 January 2017

In September 2012, Bugzilla was replaced by JIRA. You can log in using your ReactOS website credentials. Several fields are the same as before, if you have questions regarding filing bugs, please use forum.

Procedure

This page describes how to file bugs in our JIRA Bug-Tracking Software. JIRA is used in this project to gather information about failing or misbehaving components and allows us to coordinate bug fixing efforts.

First Steps

If you think you found a bug in ReactOS:

  • Make sure you can replicate your bug. Restart ReactOS and try again to make sure.
  • Check that it hasn't been reported already. The JIRA search will help you confirm this.
  • Make sure you are testing a recent and official ReactOS build. New nightly builds (preferred testing source) can be obtained here.
  • If you are running ReactOS on a virtual machine, please mind that we support QEMU, VMware and VirtualBox. Others are not supported.

Since certain bug types are out of the scope of the project, please:

  • Do not report build breakages on common platforms (Windows, Linux). Please report these on IRC or to the mailing list.
  • Do not report features announced for the next version of Windows (WinFS, etc.).
  • Do not report bugs in external components (Freetype, Wine, Mesa, etc.). Please use the other project's bug trackers for this purpose.

Important Information to Include

To make sure we can reproduce and fix your bug, certain information has to be present. Important data you should include in your report includes:

  • Reproduction method using step by step instructions.
  • Hardware or virtual machine configuration.
  • Tested ReactOS version (verify also that it does happen on nightly builds).
  • The version of the application tested (if any) and a download link (URL).
  • Screenshot of the problem if it's a graphical bug (add the attachment in JIRA).
  • Debug log for crashes, freezes and application errors. See Debugging to see how to obtain a high quality debug output.

Reporting Guidelines

To ease bug reporting and fixing, please follow these guidelines:

  • Choose a concise bug title.
  • Attach the debug log file to the bug report, instead of pasting it in. This improves the report's readability.
  • Attach pictures to JIRA directly instead of using external hosting services.
  • Use JIRA to file bugs, not to ask for support or discuss things not related to the bug.
  • Cover a single problem in the bug report, even if it happens in multiple applications or can be replicated in multiple ways.
  • Post only one issue in a single bug report.

Reports that violate these guidelines will be closed as invalid and the reporter will be asked to report the bug properly.

If any questions or problems regarding the bug reporting process arise, consult AmineKhaldi, Caemyr or gabriel_it(gone) on IRC.

Retrieved from "https://reactos.org/wiki/index.php?title=File_Bugs&oldid=43805"