Easier to read with cream paper, a tint, more contrast or larger text? Choose your colours and text, once, for every page.

Preview

Write good user stories

This is the first page of the lesson. Read it and have a go at the activities. The rest is in the full lesson.

45 minutes

One sentence, one person

Which is easier to understand?

A: "The system shall provide a facility for the retrieval of old orders."

B: "As a customer, I want to see my past orders, so that I can order the same pizza again."

B names a person, a wish and a reason. That is a user story (one sentence about who wants what, and why).

Key words

WordWhat it meansExample
User storyOne sentence that says who wants something, what they want and why.As a student, I want to pay by card, so that I do not need cash.
RoleThe kind of person in the story.student, driver, shop owner
GoalWhat the person wants to do.pay by card
ReasonWhy the person wants it. This is the value.I do not need cash
Acceptance criteriaShort checks that show the story is done.A receipt is shown after payment.
EpicA very big story that you split into smaller ones.Manage my account
BacklogThe list of all stories waiting to be built.a list on a board

The cells students fill in are left blank in this preview.

The template

PartStarts withExample
RoleAs a ...As a bus passenger,
GoalI want ...I want to see the next bus time,
Reasonso that ...so that I do not wait a long time in the rain.

The cells students fill in are left blank in this preview.

Which part of the story is it?

Have a go

Which part of the story is it?

6 questions
Have a go: your answers are marked here and then forgotten. Sign in if you would like your score kept, and to pick up where you left off.Sign in to keep your score

Your answers are marked here and are not kept. A college account keeps every student’s marks.

Quick check: good or weak?

Have a go

Quick check: good or weak?

3 questions
Have a go: your answers are marked here and then forgotten. Sign in if you would like your score kept, and to pick up where you left off.Sign in to keep your score

Your answers are marked here and are not kept. A college account keeps every student’s marks.

The lesson goes on

7 more parts of this lesson are in the full curriculum, with the tasks, the final check and the labs. A college account gives your students all of it.