launchpad help|
Size: 6232
Comment:
|
Size: 5542
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 7: | Line 7: |
| Blueprint is a lightweight way to track the progress of features and ideas, from initial concept to implementation. Using Blueprint, you can encourage contributions from right across your project's community, while targeting the coolest ideas to future [[Projects/SeriesMilestonesReleases|releases]]. | Blueprint is a lightweight way to manage releases of your software and to track the progress of features and ideas, from initial concept to implementation. Using Blueprint, you can encourage contributions from right across your project's community, while targeting the best ideas to future [[Projects/SeriesMilestonesReleases|releases]]. |
| Line 9: | Line 9: |
| With very little administrative overhead, Blueprint helps you to create a roadmap for your project and stay up to date with the status of individual features. | With very little administrative overhead, Blueprint helps you to create a roadmap for your project and shepherd individual features through to release. |
| Line 13: | Line 13: |
| = What is a blueprint = | = What is a blueprint? = |
| Line 15: | Line 15: |
| A blueprint is a simple specification. It describes an idea - such as for a feature or process - and tracks enough metadata to show who's involved and any implementation status. | A blueprint is a simple specification. It describes an idea - such as a feature or process - and tracks enough metadata to show its implementation status and who's involved. |
| Line 26: | Line 26: |
| * '''Subscribers:''' people can [[#subscriptions|subscribe]] to receive email updates when the blueprint changes. There's also an atom feed for each blueprint. | * '''Subscribers:''' people can [[#subscriptions|subscribe]] to receive email updates when the blueprint changes. |
| Line 35: | Line 35: |
| However, to allow projects to plan future releases, Launchpad restricts who can prioritise and target blueprints and bugs. As you'd expect, the project-group and project owner have these permissions but Launchpad also allows owners to grant them to other individuals and teams. Launchpad calls this delegated role the "driver". | However, to allow projects to plan future releases, Launchpad restricts who can prioritise and target blueprints and bugs. As you'd expect, the project-group and project owner have these permissions but Launchpad also allows owners to grant them to other individuals and teams. They take role that, in effect, is a release manager and that Launchpad calls the "driver". |
| Line 49: | Line 49: |
| = Targeting work = | |
| Line 50: | Line 51: |
| Launchpad Blueprint helps you to plan future release with two tools: | |
| Line 51: | Line 53: |
| * '''milestones:''' points in time, such as a future release or development sprint * '''series goals:''' a statement of intention to work on the blueprint for a particular series. Although only drivers can target blueprints to milestones and set them as series goals, anyone can propose a blueprint as a series goal. As a driver or owner, you can review proposed goals by following the ```Set goals``` link on your project's Blueprint overview page. |
|
| Line 52: | Line 58: |
| == Your project roadmap == | |
| Line 53: | Line 60: |
| As we saw earlier, you can tell Launchpad which other blueprints must be implemented before the blueprint you're working on. Launchpad uses this information to recommend the order in which you might implement your project's blueprints. Take a look at the [[https://edge.launchpad.net/ubuntu/+roadmap|Ubuntu roadmap]] for an example. <<Anchor(subscription)>> |
|
| Line 55: | Line 67: |
| * Email * Feeds |
By following the ```Subscribe yourself``` link on a blueprint page, you can ask Launchpad to send you email notification of any changes to the blueprint. In most cases, you'll receive notification only of changes made to the blueprint itself in Launchpad and not to any further information, such as in an external wiki. |
| Line 58: | Line 69: |
| However, if the wiki software supports email change notifications, Launchpad can even notify you of changes to the wiki page. | |
| Line 59: | Line 71: |
| If you're a blueprint owner and want Launchpad to know about updates to the related wiki page, ask the wiki admin how to send email notifications. Notifications should go to ```notifications@specs.launchpad.net```. | |
| Line 60: | Line 73: |
| Like a bug report, you can target a blueprint to a future release, assign it to someone to work and | = Sprints = |
| Line 62: | Line 75: |
by targeting features to future [[Projects/SeriesMilestonesReleases|releases]]. Anyone can create their own blueprint, opening your project to ideas from your community. Use the first two paragraphs to summarise all the important points about this article. Tell the reader if this is the information they need as soon as possible. = Instructional text = Where appropriate, use step by step instructions: '''Step 1:''' Give concise and unambiguous instructions. '''Step 2:''' Try not to state the obvious, unless you're writing for a novice user. {i} '''Note:''' Highlight important information with a note. '''Step 3:''' Use a well cropped screen shot if it will help orient the reader. Don't let the screen shot replace instructional text: not everyone can see your screen shot. Don't worry about borders or annotation for small, cropped screen shots such as this. {{attachment:screen-shot.png}} {i} '''Warning:''' If you're about to tell the reader to delete or otherwise change something that would be hard to restore, warn them. == Full screen shots == ||<tablestyle="float:right; font-size: 0.8em; width:30%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">{{attachment:proj-announce.png}}|| ||<style="text-align: center;">'''Describe the screen shot here'''|| Some screen shots will be better placed to the right of your text. As they're not placed directly below the text that they support, use a border and short description. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam sagittis. Aliquam eros dui, scelerisque id, consequat in, accumsan vitae, pede. Suspendisse neque ligula, scelerisque ac, mattis ut, aliquam quis, odio. Proin nunc nisi, fringilla ac, congue ac, luctus eu, lacus. Maecenas ac purus. Cras felis metus, ultricies non, euismod ac, accumsan eleifend, leo. Quisque imperdiet tempus tellus. Ut euismod, diam nec adipiscing interdum, tortor orci fringilla nisi, vel blandit erat magna at nisi. Fusce hendrerit odio non metus. Mauris nisl massa, dapibus id, feugiat quis, blandit a, quam. Integer tincidunt feugiat nunc. Curabitur iaculis egestas elit. Nam imperdiet suscipit odio. |
DRAFT: this page is a work in progress. Please seek further help or check the wiki index for a complete page on this topic.
Overview
Blueprint is a lightweight way to manage releases of your software and to track the progress of features and ideas, from initial concept to implementation. Using Blueprint, you can encourage contributions from right across your project's community, while targeting the best ideas to future releases.
With very little administrative overhead, Blueprint helps you to create a roadmap for your project and shepherd individual features through to release.
To enable Blueprint for your project, follow the Change details link on your project overview page and select the This project uses Blueprint option.
What is a blueprint?
A blueprint is a simple specification. It describes an idea - such as a feature or process - and tracks enough metadata to show its implementation status and who's involved.
Let's take a look at what information makes up a blueprint:
Title and summary: some ideas are simple enough to express fully in the summary.
Link to further information: this can be any URL and is usually a wiki page where the idea or feature is fully explored. Launchpad doesn't provide a wiki facility.
People: who's working on this blueprint? You can optionally track the person drafting the blueprint, the assignee and the reviewer.
Drafting status: how well has this been discussed? Is it still just an idea or is it ready to code?
Implementation status.
Related bugs: link to any bug reports tracked in Launchpad that will be fixed or otherwise affected by this feature.
Code branches: while you're working on the implementation, you can upload/register branches your code branches in Launchpad and link to them from the blueprint.
Subscribers: people can subscribe to receive email updates when the blueprint changes.
Dependencies: which other blueprints must be implemented before this one?
Launchpad Blueprint leaves you to manage your project in the way that you want. It imposes no project management structure but instead makes it easy for you, and your project's community, to suggest, develop and implement ideas and features.
People: roles and responsibilities
We saw above that there are certain roles associated with each blueprint. Anyone can take any of these roles and anyone can set who is in any of those roles for a particular blueprint. That makes it very easy for members of your community to suggest new features and track their progress for everyone else to see, without requiring special permission.
However, to allow projects to plan future releases, Launchpad restricts who can prioritise and target blueprints and bugs. As you'd expect, the project-group and project owner have these permissions but Launchpad also allows owners to grant them to other individuals and teams. They take role that, in effect, is a release manager and that Launchpad calls the "driver".
Drivers
Drivers come in three flavours:
- project group
- project/distribution
- project/distribution series.
Each driver's permission to target and prioritise trickles down the hierarchy, so, for example, project-group drivers also have driver permissions for each project within the group and each series in each of those projects.
As a project-group, project or distribution owner, you can set drivers by following the Appoint driver link on the relevant project-group, project, distribution or series overview page.
Targeting work
Launchpad Blueprint helps you to plan future release with two tools:
milestones: points in time, such as a future release or development sprint
series goals: a statement of intention to work on the blueprint for a particular series.
Although only drivers can target blueprints to milestones and set them as series goals, anyone can propose a blueprint as a series goal. As a driver or owner, you can review proposed goals by following the Set goals link on your project's Blueprint overview page.
Your project roadmap
As we saw earlier, you can tell Launchpad which other blueprints must be implemented before the blueprint you're working on.
Launchpad uses this information to recommend the order in which you might implement your project's blueprints. Take a look at the Ubuntu roadmap for an example.
Subscribing to blueprints
By following the Subscribe yourself link on a blueprint page, you can ask Launchpad to send you email notification of any changes to the blueprint. In most cases, you'll receive notification only of changes made to the blueprint itself in Launchpad and not to any further information, such as in an external wiki.
However, if the wiki software supports email change notifications, Launchpad can even notify you of changes to the wiki page.
If you're a blueprint owner and want Launchpad to know about updates to the related wiki page, ask the wiki admin how to send email notifications. Notifications should go to notifications@specs.launchpad.net.
