Kilimanjaro/UseCases

From MozillaWiki
Jump to: navigation, search

We are in the process of writing fully dressed use cases and are reserving this page as an index for them.

If you want to know what a fully dressed use case is, Alistair Cockburn defines it and gives lots of examples in, his book, Writing Effective Use Cases.

Use Cases by level

Peak - The highest-level stories for Kilimanjaro. The steps for the main success scenarios in these cases will consist of other use cases. Peak use cases map to enterprise or business level.

Altitude - Also high-level and likely involving more than 1 area of Mozilla. Altitude use cases map mostly to business or system use cases, but can also be user-goals that stretch across teams.

Base Camp - Bread and butter use cases which map to user-goals and are actions that can be completed in one sitting. Anything that can't be completed at a sitting or a few steps is an altitude or summary level goal. Expect to see these on a notecard.

Gear - These are low-level, technical use cases that go all the way down to implementation details. These types of use cases are at the task level. Don't expect to see them written up.

Install app from tech blog link

Level: Peak

Primary Actor: apps consumer a.k.a. android power user

Links:

Scope: System

Stakeholders and Interests:

  • External site with a link to an app wants to serve working links
  • User wants the app on their device quickly
  • App developer wants to monitor the stampede of users downloading their app from the tech blog

Precondition:

  • App is present and downloadable for the user's device in the Marketplace.
  • Consumer is performing this use case with an Android phone.
  • Consumer already has Marketplace set up for main success flow.
  • Firefox and Marketplace are rockmelted together.

Minimal Guarantees: Marketplace shows an error page, request from user is logged.

Success Guarantees: app consumer gets the app on their device and can open it.

Main Success Scenario:

  1. User opens Firefox on their device
  2. on Techcrunch page, click link that says "New York Times app"
  3. link opens Marketplace details page for app
  4. Consumer installs app from Marketplace
  5. Consumer opens app

Extensions:

1a. User does not have Firefox installed

   1b. User  sets up apps ecosystem to obtain a specific app

4a. App cannot be installed

   4b. User sees a Marketplace page saying app can't be installed

Set up apps ecosystem to obtain a specific app

Level: Altitude

Primary Actor: Apps Consumer

Scope: Black Box

Precondition:

  • Consumer does not have Firefox installed on their device
  • Consumer does not have a BrowserID/Persona account
  • Consumer has Google Play installed on their device and is logged in

Minimal Guarantees: How the interests are protected under all exits

Success Guarantees:

  • Consumer has Firefox installed on their device
  • Consumer has app installed that they initially read about on the tech blog
  • Consumer has a Persona account

Main Success Scenario:

  1. User installs Firefox from Google play
  2. User opens Firefox
  3. Firefox loads Marketplace page for app
  4. User clicks download
  5. Marketplace asks user to login/register through BrowserID/Persona
  6. BrowserID/Persona returns user to app details page in Marketplace
  7. User downloads app

Extensions: Each extension refers to a branch in behavior, good or bad, from the steps in the main success scenario.

Number of step altered followed by action or sub-use-case

Create an app from an idea in 5 Minutes

Level: Peak

Meta Bug: 746446

Primary Actor: Web Developer

Stakeholders and Interests:

  • Web Developer wants to build an app quickly
  • MDN wants to serve documents that explain tools the developer can use to developer an app and how to upload their app
  • Marketplace wants to be sure the app meets the minimum requirements and host a pointer to the app in Marketplace

Preconditions:

  • Developer has an idea for an HTML5 app but has not written the app yet.
  • Developer has written HTML5 apps before.
  • Developer has a place to host an app
  • Developer has an account with Paypal

Minimal Guarantees: MDN shows a page that it is unavailable, unsuccessful request is logged.

Success Guarantees: Developer's app is listed in the Marketplace 5 minutes after initially reading the MDN pages. Developer can see statistics of people downloading her app from the Marketplace

Main Success Scenario:

  • Web developer clicks link that says "Go from idea to app in 5 minutes"
  • A page on MDN titled "Go from idea to app in 5 minutes" opens
  • Developer uses tools to create an app including hosting it somewhere
  • Developer uploads the app to the Marketplace for $0.99
  • After a week, the Developer reads reviews left of her app

Extensions: List the extensions, one at a time, each referring to the step of the main scenario.

Step altered, action or sub-use-case

Technology & Data Variations List: Variations that will cause branching in the scenarios such as operating systems

Introduce Firefox Consumer to HTML5 apps and the Mozilla Marketplace

Level: Peak Meta bug: Bug 746480

Primary Actor: Firefox Browser

Secondary Actors:

  • Firefox Consumer
  • Mozilla Marketplace

Scope: Black box

Stakeholders and Interests: Firefox wants to successfully update and give the user a pleasant introduction to HTML5 apps and the Mozilla Marketplace

The Firefox Consumer wants their browser to update successfully.

Precondition:

  • The consumer already has Firefox installed
  • Firefox is at the latest version.

Minimal Guarantees:How the interests are protected under all exits

Success Guarantees:

  • Consumer's Firefox browser is updated.
  • Consumer has a BrowserID/Persona account
  • Consumer has an app on their desktop
  • Consumer has an app on a mobile device
  • Statistics for the app's downloads are updated

Trigger: Update to Firefox 14

Main Success Scenario:

  1. The consumer opens Firefox
  2. Firefox updates itself
  3. Desktop Firefox helps the consumer discover Firefox, mobile, apps and ID
  4. Consumer explores the Marketplace
  5. Consumer installs an app to his Desktop
  6. Consumer registers for BrowserID/Persona
  7. Consumer installs the Marketplace on a separate device

Extensions:

3a. Consumer does not want to be introduced at this moment in time Technology & Data Variations List: Variations that will cause branching in the scenarios such as operating systems

  3b. Will the Browser have a "remind me later" feature that the consumer can return to later?

Set up a new Boot-2-Gecko Phone for a Consumer

This one is in progress

Level: Peak

Scope: Black box

Primary Actor: Clerk for a Mobile Phone Carrier

Stakeholders and Interests:

  • The consumer wants
    • The new phone to contain their old contacts
    • A marketplace installed so they can download some new apps
    • The mobile equivalent of their desktop app to show up on the phone

The clerk wants to import the users old contacts and get them signed into persona.

The phone carrier wants to know that the phone as been properly activated so they can bill the consumer.l

Precondition:

  • The user already has a persona account
  • The user has some apps installed on their desktop

Minimal Guarantees:How the interests are protected under all exits

Success Guarantees: The state of the world if the goal succeeds

Trigger: What starts the use case, may be a time event

Main Success Scenario: Steps of the scenario from trigger to goal delivery and any cleanup after

Step number, action description

Extensions: Put here there extensions, one at a time, each referring to the step of the main scenario.

Step altered, condition: action or sub-use-case

Technology & Data Variations List: Variations that will cause branching in the scenarios such as operating systems