Who should be able to do what, and how? (See "guidelines" below.)
e.g: As a manager, I want to be able to understand my colleagues' progress, so I can better report our success and failures.
What happens behind the scenes?
Indicators / requirements that must be fulfilled when the story is implemented.
Descriptions of how each special case is handled.
Link to the designs of this user story. If the design does not have an interactive layer, add a flowchart or description of how the user moves between the different views.
Which API calls is this based on? Which ones of them exist, which ones should be implemented for this? Maybe also show some example API calls.
As a <persona>:
We’re after the persona of the person. We understand how that person works, how they think and what they feel. We have empathy for them.
Wants to:
Describe their intent, not the features they use. This statement should be implementation free. If you’re describing any part of the UI and not what the user goal is you're missing the point.
So that:
How does their immediate desire to do something this fit into their bigger picture? What’s the overall benefit they’re trying to achieve? What is the big problem that needs solving?