= Launchpad Enhancement Proposal Process =

'''Where's the beef?  Go to the [[LEP|List of drafting, approved and archived LEPs]]!'''  Go to the '''[[LaunchpadEnhancementProposalTemplate|template]]'''.

 * '''Process Name:''' Launchpad Enhancement Proposal process
 * '''Owner:''' [[https://launchpad.net/~launchpad-strategist|Launchpad Product Strategist]]
 * '''Parent Process/Activity:'''
 * '''Supported Policy:''' None

== Description ==

A way of proposing an enhancement to Launchpad, so that we're ReadyToCode as quickly as possible.

== Do I need to follow this? ==

You '''must''' follow this if:
 * you are adding a new feature
 * you are reworking an existing feature
 * you are extending or changing the workflows of an existing feature
 * you have spent more than thirty minutes talking about the change without doing it

You '''probably don't need''' to follow this if:
 * you are making a change that's not visible to users,
 * you are fixing a shallow defect, or
 * you already have answers for each item on the ReadyToCode checklist

The first list overrides the second list. When in doubt, ask the Product Strategist.

== Rationale ==

Launchpad regularly develops new features. We'd like to make sure that these features are implemented well, and that they are what our users actually need.

This process is successful if it helps us make exactly what users want, with no wasted extra features and no crappy pain points in the new interfaces.

In particular, we want to have feature definitions that:
 * Produce requirements for use by Launchpad developers
 * Can inform QA
 * Make it easy for timely input from people who are interested
 * Do not specify implementation approaches

== Triggers ==

This process is triggered when you want to do a new feature, or when beginning work on a feature squad.

== Roles ==

 * Product Strategist
 * Analyst
 * Stakeholders

The Product Strategist triggers this process and approves any output from it.

The Analyst is the author of any of the outputs. The Analyst can be any Launchpad developer or community member. The Strategist should be available to take the role of doing the actual writing, particularly if the Analyst finds it a burden. The thinking must come from the Analyst.

== Inputs ==

The input should include as many [[UserStories|user stories]] as possible with a form like:

 '''As a''' $PERSON<<BR>>
 '''I want''' $FEATURE<<BR>>
 '''so that''' $BENEFIT<<BR>>

There must also be a list of Stakeholders &mdash; people who are actually interested in the feature.

The input should also include a written reason as to why we are working on this feature right now, instead of other features that we could be doing.

Any existing user research data should be considered as input.

== Process ==

=== Collect the inputs ===

Make sure you have:
 * A list of Stakeholders
 * Some [[UserStories|user stories]] &mdash; This helps the Product team later with [[https://wiki.canonical.com/Launchpad/PolicyandProcess/UserResearch|user research]] and [[https://wiki.canonical.com/Launchpad/PolicyandProcess/ExploratoryTesting|exploratory testing]]

=== Create the wiki page ===

 1. Make a page on https://dev.launchpad.net/, give it a short, punchy name
 1. Consider using the LaunchpadEnhancementProposalTemplate
 1. List the Stakeholders at the top
 1. Add the story
 1. Add the wiki page to the "Drafting" section of [[LEP]]

=== Talk to someone ===

Talk to someone, anyone. Talk over the phone and make notes with something like Gobby, or just on the wiki page directly.

Good people to talk to include Stakeholders and the Product Strategist.

=== Talk to the product strategist ===

Just in case you missed it, you should really talk to the Product Strategist.

=== Start adding constraints ===

A ''constraint'' is some condition that the solution must satisfy. The constraints listed here should be:
 * specific, avoid &ldquo;motherhood and apple pie&rdquo; statements such as &ldquo;feature must be awesome&rdquo;
 * testable, it should be clear when the constraint is satisfied

But actually, the more the merrier. Get them down first, get them right later.

It's important to work with Stakeholders at this stage. Remember to ask &ldquo;why&rdquo; a million times over so that we get the right constraint down.

These constraints should '''not''' specify a solution.

Often, it's very helpful to describe what things are not included as part of the feature.

=== Jot down sub-features ===

Thinking about the problem will probably lead you to discover sub-features, smaller things that can be delivered independently and will add value while building up to reach the bigger story.

These sub-features can have their own feature document / blueprint thing, or they can go down in this document.

Either way, each sub-feature should go through a process very similar the one of the overall feature.

=== Delete any unused sections ===

It makes the document easier to read.

=== Get it reviewed ===

Move the link to the proposal on [[LEP]] from "Drafting" to "Needs approval".

Review the output with the Product Strategist, who will move it on to "Ready to code" or bounce it back to "Drafting".

This process is complete when we feel we have enough information to start designing a UI. Remember the process is iterative. It's expected that the actual constraints will be better understood as we start to design & implement.

=== Success criteria ===

Answer the following questions:
 * How will we know when it's done?
 * How will we know if it's done well?

== Output ==

A wiki page and a link on [[LEP]].

If not already, the LEP should be raised for discussion on the development mailing list.

Consider blogging or tweeting about it.

If the LEP is really, actually to be done, then make sure that it is linked from the RoadMap.

When doing user testing of this feature, use the LEP as a reference.

== Notes ==

=== What is a requirement? ===

 * A constraint on a feature
 * Makes the "value" of the feature apparent
 * You can do an experiment that shows whether or not the requirement is met
 * A requirement is always for someone for some benefit
 * Is not set in stone
 * Does not specify a solution

== Supporting Documentation ==

 * [[PolicyAndProcess/LEPImplementationReview|LEP Implementation Review Process]]
 * [[LEP|List of LEPs]] -- use these for examples of the form and inspiration of what to include