launchpad help|
Size: 4662
Comment:
|
Size: 4997
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 86: | Line 86: |
| Most feed readers will automatically discover the bug feed if you give them the URL of the bug report or the person, team, project or distribution overview page. The bug feeds takes the format: | Most feed readers will automatically discover the bug feed if you give them the URL of the bug report or the person, team, project or distribution overview page. Alternatively, you can build the bug feed URL by hand: |
| Line 90: | Line 92: |
| Replace <number> with the bug number. | Replace ```<number>``` with the bug number. |
| Line 96: | Line 98: |
| Replace <project or distro name> accordingly. |
Replace ```<project or distro name>``` accordingly. |
| Line 104: | Line 104: |
| Replace <person or team name> accordingly. | Replace ```<person or team name>``` accordingly. |
| Line 106: | Line 106: |
| http://feeds.launchpad.net/~bzr/latest-bugs.atom | For example: http://feeds.launchpad.net/~bzr/latest-bugs.atom = Next steps = Once you've reported and commented on a few bugs, you might want to get more involved in the day to day management of a project's bugs. The role of [:Bugs/BugContactRole:bug contact] is one of the most important to a project that uses Launchpad's bug tracker. |
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.
ContentsBRTableOfContents |
Overview
Launchpad uses notification emails and Atom feeds to help you stay on top of the bugs that interest you.
Bug mail
There are three ways to get bug notifications by email:
- subscribe to a bug
- subscribe to a milestone, project, package or distribution
- take a role that results in bug mail:
- bug reporter
- assignee
- commenter
project or package [:Bugs/BugContactRole:bug contact].
Subscribing to an individual bug is as simple clicking Subscribe on the bug report page. You can also subscribe another individual or a team to a bug. However, you should only do this if you're certain the person or team members are happy for you to do so.
Subscribing to an entire milestone, project, package or distribution
If you're the bug contact for a package or project you'll automatically receive email about updates to any bugs relating to that package or project.
To receive notifications about a milestone in a project, a distribution (e.g. Ubuntu) or a package or project for which you're not a bug contact, click Subscribe to bugmail in the Actions menu on the milestone, project, package or distribution bugs overview page.
What you'll receive
Launchpad sends bug notifications when:
- a new bug is reported
- someone makes a comment on a bug
- a bug's status or importance changes
- a bug is assigned to someone
- a bug is targeted to a milestone
- a bug is marked as affecting a new series, package or project.
You can filter bug mail based on both the subject and headers. A prefix of [NEW] in the subject lets you distinguish emails about newly reported bugs from updates about previous bugs.
Here's an example of the headers Launchpad added to an email about a bug reported against Exaile:
{{{X-Launchpad-Bug: product=exaile; status=Confirmed;
- importance=Low; assignee=None;
X-Launchpad-Bug-Private: no X-Launchpad-Bug-Security-Vulnerability: no X-Launchpad-Message-Rationale: Subscriber (Exaile)
- @exaile
}}}
They're fairly self-explanatory but the content of X-Launchpad-Bug differs depending on whether the email is about a distribution package or an upstream project.
Project:
product: the project's Launchpad name
status
importance
assignee
Distribution package:
distribution
sourcepackage
component
status
importance
assignee
Unsubscribing
You can unsubscribe from bug notifications at any time.
Individual bugs: visit the bug report and click Unsubscribe in the Actions menu. All bugs in a particular context: visit the context's overview page - such as a project's overview page - and select Subscribe to bug mail. Follow this if you're a bug contact but no longer want to receive the associated bug notifications.
Note: if you receive bug mail because you're in a team that is a bug contact, reporter, commenter or assignee, you must leave that team to stop receiving the notifications.
Atom feeds
attachment:google-reader-bugs-feed3.png |
A bugs feed in Google Reader |
You can subscribe to a feed of the bugs that affect a person, team, project or distribution. You can also subscribe to individual bugs.
Most feed readers will automatically discover the bug feed if you give them the URL of the bug report or the person, team, project or distribution overview page.
Alternatively, you can build the bug feed URL by hand:
Individual bugs: http://feeds.launchpad.net/bugs/<number>/bug.atom
Replace <number> with the bug number.
For example: http://feeds.launchpad.net/bugs/1/bug.atom
Projects and distributions: http://feeds.launchpad.net/<project or distro name>/latest-bugs.atom
Replace <project or distro name> accordingly.
For example: http://feeds.launchpad.net/ubuntu/latest-bugs.atom
People and teams: http://feeds.launchpad.net/~<person or team name>/latest-bugs.atom
Replace <person or team name> accordingly.
For example: http://feeds.launchpad.net/~bzr/latest-bugs.atom
Next steps
Once you've reported and commented on a few bugs, you might want to get more involved in the day to day management of a project's bugs. The role of [:Bugs/BugContactRole:bug contact] is one of the most important to a project that uses Launchpad's bug tracker.
