Difference between revisions of "Reporting bugs"

From Pandora Wiki
Jump to: navigation, search
(more details and other changes)
(Redirected page to Ångström#Reporting bugs)
 
(9 intermediate revisions by 7 users not shown)
Line 1: Line 1:
Please do make sure that you are using the latest official firmware and hotfix. You can find it in the [http://www.open-pandora.org/index.php?option=com_content&view=article&id=178&Itemid=32&lang=en official support section of the website]. Reports made against older versions might be invalid since the issues were already fixed.
+
#REDIRECT [[Ångström#Reporting_bugs]]
 
 
If the bug does still exist in the latest released version, please follow these steps when reporting it in the [http://bugs.openpandora.org official bug tracker]. You will need to register an account in the tracker. Once you are logged into the account, just click on ''Add new task'' to see a form where you can provide the information required to assign and solve the bugs. Below is an explanation of what you should enter where.
 
 
 
'''Stuff that belongs there''':
 
* Bugs that happen with the default operating system on the pandora.
 
* Things missing in the default operating system on the pandora.
 
* Bugs and issues with the codec pack.
 
 
 
'''What does not belong in the official tracker''':
 
* Bugs with other .pnd files like eg emulators, games or other applications that are not part of the main OS.
 
* Features missing in other progs.
 
 
 
Here is the list of things you should keep in mind and mention in your bug report or feature request to make sure that it can be solved. Please do also make sure to react on comments that are left in the report, since the people that feel responsible for solving the issues might need more information that only you can provide.
 
 
 
===Summary===
 
This should be a really short summary of the issue at hand, as clean as possible. Something like eg ''ABC does not work'' is not good, better write ''ABC crashes when sounds are played''.
 
 
 
===Drop Down Boxes===
 
This area on the left side is used to provide some general information that makes it easier for devs to assign the reports to the correct people for fixing things. They are often useful in fixing the report in the end, too.
 
====Task Type====
 
Just select it from the drop down box. If you want to report a bug, make it ''Bug Report'', if it is a missing feature, select ''Feature Request''.
 
 
 
====Category====
 
* ''Backend / Core'': Basically kernel/driver related stuff
 
* ''Base OS'': Stuff related to the basic system and tools shipped with it.
 
* ''Application'': Meant for some additional applications, like eg tools that the OpenPandora team does provide for your system at home, not directly the pandora. This is not meant for 3rd party apps.
 
 
 
====Status====
 
Can only be changed by bug tracker admins (aka "official pandora devs").
 
 
 
====Operating System====
 
This is only relevant if the issues is '''not''' on the pandora itself but with some tool that you got to use on your computer to get the pandora stuff to work (eg a network connection via usb networking). If the report is directly related to the pandora, just leave this entry at ''All''.
 
 
 
====Severity====
 
How important do you estimate this bug/issue? It should only be marked ''critical'' if it is a real security breach or something breaking *everything*. Often the default ''low'' is fine, since the values can be adjusted later on by bug tracker admins.
 
 
 
====Priority====
 
Can only be changed by bug tracker admins (aka "official pandora devs").
 
 
 
====Reported Version====
 
Here you can select the Pandora OS version that you use. This will be kept up to date with the latest firmware releases, though it might be outdated. If you can't enter the correct version here, please make sure to list it in detail in the "details" section. In case that this report is not about the pandora itself, just select what you think appropriate (often "development" should work then).
 
 
 
===Details===
 
A neat, large field with lots of space for all the details that you can provide. Yes, in general a case of "the more, the better" applies here. Here is a list of things that you should mention in the report:
 
 
 
====Problem====
 
Detailed description of the *exact* problem you see. Please do include some log output, if you have it available.
 
 
 
====Reproducibility====
 
How often does the issue occur? Is it reproducible? If it is, please provide detailed steps to do so.
 
 
 
====Actual Results====
 
What happened after you performed the steps you listed under "Reproducibility"?
 
 
 
====Expected Results====
 
What should have happened?
 
 
 
====Additional Information====
 
Please do list any additional information, like for example the *exact* version of your OS (or the application). This is especially important if you were not able to select the exact version in the '''Reported Version''' drop down field.
 

Latest revision as of 06:10, 7 November 2013