Diff for "ReportingABug"

Not logged in - Log In / Register

Differences between revisions 1 and 5 (spanning 4 versions)
Revision 1 as of 2007-01-10 18:08:39
Size: 366
Editor: 82-47-115-15
Comment:
Revision 5 as of 2007-02-21 14:49:41
Size: 2849
Editor: 62-31-78-42
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
If you come across a problem (bug) in the software you use, you can help out by reporting the bug to the team that maintains the software. Bugs are problems that occur in software. If you come across a bug, you can help to fix it by reporting it to the people that produce the software.
Line 3: Line 3:
'''Important:''' Before you report a bug, you should: You can use Launchpad to report a bug if:
Line 5: Line 5:
 * Repeat the steps that led up to the bug's occurrence and confirm that it wasn't a one-off.
 * Check that the behaviour isn't an intended feature of the software.
 * you found it whilst using a Linux distribution that manages bugs in Launchpad, such as one of the Ubuntu family
 * or the software's website tells you that it uses Launchpad to manage bug reports.


== Confirming the bug exists ==

Before you report a bug, it's important to confirm that it wasn't a one-off.

Think about what you were doing before the bug happened, then repeat the same steps. If the problem happens again, you should report the bug.

== Bugs in the Ubuntu family ==

{i} '''Note:''' To report a bug directly with the project that creates the software, skip to the section ''Bugs in other software''.

'''Step 1:''' Visit https://launchpad.net/ubuntu/+filebug

'''Step 2:''' Enter a brief summary of the bug you've found. '''Example:''' ''Program X crashes when editing multiple documents''.

'''Step 3:''' Launchpad will search existing bugs and show you a list of bugs that appear similar to the one you've reported. You'll also see a list of the bugs that people report most often.

Check the bugs that Launchpad lists. If one appears to be the same as the problem you encountered, click it, then skip to the section titled ''Adding comments to an existing bug''.

'''Step 4:''' If you don't see a similar bug in the list that Launchpad shows you, scroll down to the section headed ''In which package did you find this bug?''

The software in your Linux distribution is held in packages. To identify where you found the bug, you need to specify the appropriate package. Click '''Choose'''.

attachment:choose-package.png

'''Step 5:''' A pop-up window will open. Use the text-box to enter the name of the software you were using, then click '''Search'''. If you see a package name similar to the name of the software you were using, click it. Otherwise, close the pop-up window without entering a package name.

'''Step 6:''' In the large text-box, beneath your one-line summary, give as much information as you can about the bug. Useful information includes:
 
 * What the software did to make you think a bug had occurred.
 * Exactly what you were doing when the bug happened - describe what someone else would have to do to see the bug.
 * Any error messages or anything else that you saw.

{i} '''Quick-tip:''' You can learn what information is most useful in the article [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to report bugs effectively].

'''Step 7:''' When you've given as much relevant information as possible, click the '''Submit Bug Report''' button.

Launchpad will now email the Linux distribution's bug team, to let them know that you've created a bug.

Bugs are problems that occur in software. If you come across a bug, you can help to fix it by reporting it to the people that produce the software.

You can use Launchpad to report a bug if:

  • you found it whilst using a Linux distribution that manages bugs in Launchpad, such as one of the Ubuntu family
  • or the software's website tells you that it uses Launchpad to manage bug reports.

Confirming the bug exists

Before you report a bug, it's important to confirm that it wasn't a one-off.

Think about what you were doing before the bug happened, then repeat the same steps. If the problem happens again, you should report the bug.

Bugs in the Ubuntu family

{i} Note: To report a bug directly with the project that creates the software, skip to the section Bugs in other software.

Step 1: Visit https://launchpad.net/ubuntu/+filebug

Step 2: Enter a brief summary of the bug you've found. Example: Program X crashes when editing multiple documents.

Step 3: Launchpad will search existing bugs and show you a list of bugs that appear similar to the one you've reported. You'll also see a list of the bugs that people report most often.

Check the bugs that Launchpad lists. If one appears to be the same as the problem you encountered, click it, then skip to the section titled Adding comments to an existing bug.

Step 4: If you don't see a similar bug in the list that Launchpad shows you, scroll down to the section headed In which package did you find this bug?

The software in your Linux distribution is held in packages. To identify where you found the bug, you need to specify the appropriate package. Click Choose.

attachment:choose-package.png

Step 5: A pop-up window will open. Use the text-box to enter the name of the software you were using, then click Search. If you see a package name similar to the name of the software you were using, click it. Otherwise, close the pop-up window without entering a package name.

Step 6: In the large text-box, beneath your one-line summary, give as much information as you can about the bug. Useful information includes:

  • What the software did to make you think a bug had occurred.
  • Exactly what you were doing when the bug happened - describe what someone else would have to do to see the bug.
  • Any error messages or anything else that you saw.

{i} Quick-tip: You can learn what information is most useful in the article [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to report bugs effectively].

Step 7: When you've given as much relevant information as possible, click the Submit Bug Report button.

Launchpad will now email the Linux distribution's bug team, to let them know that you've created a bug.

ReportingABug (last edited 2009-08-12 16:02:07 by 92-237-59-186)