Difference between revisions of "User story"

From Pearl Language
Jump to navigation Jump to search
(→‎Sources: += Crisp » David Evans, Gojko Adzic » “As a, I want, So that” Considered Harmful)
(→‎Sources: += InfoQ » Sergio De Simone » Leslie Lamport on Distributed Systems and Precise Thinking)
Line 92: Line 92:
''List any assumptions on which the story, its design and decisions is based.''
''List any assumptions on which the story, its design and decisions is based.''
*{{color|red|To be discussed}}.
*{{color|red|To be discussed}}.
==Requirements==
Leslie Lamport on Distributed Systems and Precise Thinking:
{{quote|The benefit of using [a formal specification language] is that it teaches you to think rigorously, to think precisely, and the important point is the precise thinking. So what you need to avoid at all costs is any language that's all syntax and no semantics.|Leslie Lamport}}


==Sources==
==Sources==
Line 179: Line 183:
|title=“As a, I want, So that” Considered Harmful
|title=“As a, I want, So that” Considered Harmful
|about=using more effective ways to capture a story
|about=using more effective ways to capture a story
}}
{{WebSourceListItem
|url=http://www.infoq.com/news/2014/10/ser-lamport-interview
|site=InfoQ
|person=Sergio De Simone
|title=Leslie Lamport on Distributed Systems and Precise Thinking
|about=using formal language for requirements and coding
}}
}}

Revision as of 10:31, 17 October 2014

…{{{context}}}

✣  ✣  ✣

{{{wish full}}}

The cost of a story includes providing the capability and maintaining a healthy codebase for future work.
Martin Fowler

Therefore:

Use the story splitter to make all user stories similar-sized items.

✣  ✣  ✣



✣  ✣  ✣

Template

Legend

color meaning
black To be implemented in the current variant of the user story.
red Issues that must be researched and resolved before you can start with implementation.
grey Items that will not be implemented in the current variant of the user story (out of scope).

Verb-sentences, please

When composing the title of a user story, use verb-sentences and active language. The verbs are the actions and activities users can do with your product. The nouns are the objects or parts that make up your product.

For example:

  • To send a message.
  • To delete a message.
  • To close a partnership.

Context

Describe the context or situation in which this story shows its value at best.

Gist

Describe the essence, the ‘gist’ of the user story in its context.

Story Template

Slightly different from the “As a role I want to function so that I value.”

When I situation am in the city
I want to feature (verb sentence) withdraw cash
so that I value, benefit buy some ice cream and quench my thirst.

Ready to Build

Describe the user’s adventure as a narrative, a story, until everyone can back brief the story crystal clear, lucid way. In short, make sure the user story is ready to build.

Issues

Issues that need to be resolved before the user story can be declared ready to build. Color open issues red. Color them black when resolved. For example:

  • How many daily withdrawals are allowed?
  • What is the maximum amount someone can withdraw and on what does it depend?
    • Maximum daily withdrawal amount is minimum(account balance, credit limit, cash in ATM).
  • Offer a loan when the withdrawal amount exceeds the account balance.

To do

Describe what needs to be done to get (a path through) the story ready to build, especially to split them into similar-sized items.

Seeing is believing

Tersely describe in steps how the path through the user story will be demonstrated. Pay special attention to edge cases. Steps in grey are excluded from the current revision of the story, and are used to illustrate what the complete story looks like.

Design

Describe the conceptual technical design of the story. Include any diagrams that clarify its implementation direction.

Acceptance

When appropriate, use specification by example and behavior-driven development in conduction with #Seeing is believing to obtain crystal clear acceptance criteria.

Scope

Explicitly specify what is in scope, and especially what is out of scope for this revision of the story.

In scope

  • To be discussed.

Out scope

  • To be discussed.

Decisions

List any decisions and their rationale.

  • To be discussed.

Assumptions

List any assumptions on which the story, its design and decisions is based.

  • To be discussed.

Requirements

Leslie Lamport on Distributed Systems and Precise Thinking:

The benefit of using [a formal specification language] is that it teaches you to think rigorously, to think precisely, and the important point is the precise thinking. So what you need to avoid at all costs is any language that's all syntax and no semantics.
Leslie Lamport

Sources