Skip to content

Commit e3a76c4

Browse files
author
jasonBirchall
committed
♻️ Merge requirements into single “What’s Needed” list
This came out change was the result of a Ways of Working session the team. This update collapses the functional and non-functional requirement sections into a single 'What’s Needed' list, adopting friendlier language throughout so the template remains approachable while still capturing both what a feature must do and the necessary behaviours.
1 parent 8d0e12e commit e3a76c4

1 file changed

Lines changed: 23 additions & 27 deletions

File tree

Lines changed: 23 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,83 +1,79 @@
11
---
22
name: User Story
3-
about: Capture a user story from stakeholders, ensuring a focus on user outcomes and clear communication.
3+
about: Capture a user story with clear outcomes and an easy-to-read list of what’s needed.
44
title: ''
55
labels: user-story
66
assignees: ''
7-
87
---
98

109
**User Need**
1110

12-
**As a** (type of user)
13-
**I want** (some action)
11+
**As a** (type of user)
12+
**I want** (some action)
1413
**so that** (some result)
1514

1615
---
1716

18-
**Functional Requirements (What):**
19-
20-
- [ ]
17+
### What’s Needed
2118

22-
**Non-Functional Requirements (How):**
19+
List anything the solution must do or be (behaviour, performance, security, UX, etc.).
2320

24-
- [ ]
21+
- [ ]
2522

2623
---
2724

28-
**Acceptance Criteria:**
25+
### Acceptance Criteria
2926

30-
- [ ] The functional and non-functional requirements are fulfilled.
31-
- [ ] Changes (if any) during delivery are reflected in this story.
32-
- [ ] Impacted users have been notified or communicated with appropriately (e.g., change logs, Slack, documentation updates).
27+
- [ ] Everything in **What’s Needed** is delivered.
28+
- [ ] Any changes during delivery are reflected in this story.
29+
- [ ] Impacted users have been informed appropriately (e.g. change logs, Slack, docs).
3330

3431
---
3532

36-
**User Communication Plan (if applicable):**
33+
### User Comms Plan (if applicable)
3734

38-
Describe briefly how users will be informed about the change (e.g., Slack message, email, platform announcement).
35+
Briefly describe how you’ll let users know about the change.
3936

4037
---
4138

42-
**Assumptions (optional):**
39+
### Assumptions (optional)
4340

4441
-
4542

4643
---
4744

48-
**Risks and Mitigation (optional):**
45+
### Risks & Mitigation (optional)
4946

5047
-
5148

5249
---
5350

54-
**Notes:**
51+
### Notes
5552

56-
(Add any additional context, links to diagrams, stakeholder interviews, etc.)
53+
(Add any extra context, links, diagrams, stakeholder interviews, etc.)
5754

5855
---
5956

6057
<!-- Field explanations:
6158
62-
As a (type of user): The role that the stakeholder or user plays (developer, project manager, security team, etc.).
59+
As a (type of user): The role the stakeholder or user plays (developer, PM, security team, etc.).
6360
6461
I want (some action): The specific action, functionality, or change the user is requesting.
6562
6663
so that (some result): The benefit or reason behind the action.
6764
68-
Functional Requirements: What you are building — feature behaviours or system capabilities.
69-
70-
Non-Functional Requirements: How it should behave — performance, security, reliability, etc.
65+
What’s Needed: A single list covering both functional and non-functional aspects—what the feature must do and how it must behave (performance, security, reliability, etc.).
7166
7267
Acceptance Criteria: Clear, measurable conditions to verify the story is complete and valuable.
7368
74-
User Communication Plan: How users will be made aware of relevant changes or impacts (essential for user trust).
69+
User Comms Plan: How users will be made aware of relevant changes or impacts.
7570
76-
Assumptions: Important assumptions that inform how the story is delivered.
71+
Assumptions: Important assumptions informing delivery.
7772
78-
Risks and Mitigation: Risks associated with the story and how they will be handled.
73+
Risks & Mitigation: Risks associated with the story and how they will be handled.
7974
80-
Notes: Any other useful information.
75+
Notes: Any other useful information.
8176
8277
Tip: Update this story if the scope changes during delivery to maintain clarity for everyone.
8378
-->
79+

0 commit comments

Comments
 (0)