User Story Template and Examples
The concept of user stories comes from the practice of agile software development, but requires no computer coding nor technical language to create. Rather, they are a series of simple statements, written in plain language, designed to guide the execution of a technical element within a software application. For more info, look at http://en.wikipedia.org/wiki/Use_case or checkout any of the available literature on agile software development and other practices such as "scrum." Bear in mind, however, that you don't need to know any of that in order to write a good user story!
Format
Stories are usually short paragraphs consisting of at least three parts:
- A user, such as an administrator, archivist, or public user
- A desired action, feature, outcome, or limitation
- A benefit or reason for the above action, feature, outcome, or limitation
- A narrative (optional)
- A benchmark for completion, i.e. "What does done look like?" (optional)
Additionally, user stories may have a narrative component that is written in paragraph form where the author can expound on deeper aspects to the story, or provide more context, but the narrative should be viewed as optional and that the three parts of the user story should stand on its own and be sufficient to explain everything.
Lastly, it's sometimes helpful to include a brief statement that serves as a litmus test indicating a successful outcome. This is optional, but helps developers and managers know what to aim for when performing the work.
Examples
Short
As an archivist
I want to create folders of content
So that I can hierarchically arrange my content
Medium
As an archivist
I want to link digital content to my finding aids
In order to make my content appear within a collection
What does done look like?
When I see images appear in my finding aid that are part of that collection
Long
Narrative
The FBI showed up the other day and gave us a hard time about the some content that I was on one of our sites and issued a cease and desist order.
Story
As an administrator or archivist
I need to restrict access to specific components in my collections
Because I need to comply with copyright laws
What does done look like?
When I can't find any information that is marked as under copyright.