'''DRAFT: this page is a work in progress. Please [[Feedback|seek further help]] or check the [[TitleIndex|wiki index]] for a complete page on this topic.'''

||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>||

= Overview =

[[https://launchpad.net/~jelmer/|Jelmer Vernooij]] works on a number of projects in Launchpad. 

If we visit [[https://bugs.launchpad.net/~jelmer/|his bugs overview page]], we can see that he's involved with hundreds of bugs tracked in Launchpad.

||<tablestyle="font-size: 0.8em; width:30%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">{{attachment:jelmer-bugs.png}}||
||<style="text-align: center;">'''Bugs related to jelmer Vernooij'''||

Using the ```Actions``` menu, you can refine the list to see which bugs Jelmer has reported, which he's working on, which he's commented on and so on.

If you've only recently joined Launchpad, [[https://bugs.launchpad.net/people/+me|your own bugs overview page]] may not have as much content but, once you start reporting and working on bugs, it'll give you a useful picture of the bugs you're involved with.

<<Anchor(reporting)>>
= Reporting bugs =

[[https://bugs.launchpad.net/bugs/+filebug|Reporting a bug]] using Launchpad is straightforward. However, there are one or two things to look out for:

 * '''[[Bugs/Notifications|Bug notifications]]:''' you'll receive email updates about any bug you report, comment on or are otherwise involved with.
 * '''Package or project:''' Launchpad tracks bugs both for upstream projects and distribution packages of those projects.

Bug notifications are a useful way to keep up to date with bugs and we'll [[Bugs/Notifications|look at them later]] in this guide.

== Package or project ==

Let's say you're reporting a bug in Inkscape. The Inkscape project uses Launchpad as its bug tracker. Ubuntu also uses Launchpad to track bugs and has an Inkscape package.

This may sound confusing but Launchpad gives us some big clues as to whether we're looking at the Inkscape project or a distribution package of Inkscape, such as Ubuntu's.

||<tablestyle="font-size: 0.8em; width:30%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">{{attachment:inkscape-bugs.png}}||
||<style="text-align: center;">'''Bugs in the Inkscape project'''||

||<tablestyle="font-size: 0.8em; width:30%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">{{attachment:inkscape-ubuntu-bugs.png}}||
||<style="text-align: center;">'''Bugs in Ubuntu's Inkscape package'''||

Where you report the bug depends on where you found it. If you find a bug while using a distribution that tracks its bugs in Launchpad - such as Ubuntu - you should report the bug against the distribution. However, if you find it elsewhere, you should report it directly against the project itself.

= Next steps =

Launchpad helps you stay informed of a bug's progress both by email and Atom feed. Let's look at how you can [[Bugs/Subscriptions|subscribe to bug notifications]].