x/development-proposals
Code Issues Proposed changes

Adds Acceptance Criteria to User Story Template

Browse Source 
During the PWG Working Session on 10/27/16 in BCN
I took the action to add acceptance criteria to
the template.

In order to do so I also had to adjust the template
to suggest adding Use Case references.

Change-Id: Ic54f2d475007722441deb72292d6e169649f6edc
This commit is contained in:
Kenny Johnston
2016-10-28 12:04:14 +02:00
parent 853e6c88a7
commit e52bb9cc9e
1 changed files with 23 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
user-story-template.rst
View File

@@ -61,10 +61,13 @@ User Stories
.. separate submission for each group of user stories. Please replace "None." with .. separate submission for each group of user stories. Please replace "None." with
.. the appropriate data. .. the appropriate data.
.. A list of user stories targetted at OpenStack UX Personas, ideally in this .. Please provide a unique three character reference and three digit number for
.. each user story
.. A list of user stories targeted at OpenStack UX Personas, ideally in this
.. or a similar format: .. or a similar format:
.. * As `<type of user>`_, I want to <goal> so that <benefit> .. * XXX### As `<type of user>`_, I want to <goal> so that <benefit>
This section utilizes the `OpenStack UX Personas`_. This section utilizes the `OpenStack UX Personas`_.
@@ -91,6 +94,22 @@ Usage Scenario Examples
None. None.
Acceptance Criteria
+++++++++++++++++++
.. This section is mandatory
.. In order to define completed implementation of a user story, provide
.. detailed definitions of acceptance criteria for these stories. This should
.. include where applicable the specific project set appropriate, the user
.. focused experience and in some cases references to types of specific
.. artifacts.
.. Please reference the user stories by three character and three number
.. references defined above.
.. Ex. ABC123 - All Interop Projects obtain tag "FOO"
None.
Related User Stories Related User Stories
++++++++++++++++++++ ++++++++++++++++++++
.. This section is mandatory. .. This section is mandatory.
@@ -107,7 +126,7 @@ None.
.. apparent through the user story and usage examples. This information will help .. apparent through the user story and usage examples. This information will help
.. the development be aware of any additional known constraints that need to be met .. the development be aware of any additional known constraints that need to be met
.. for adoption of the newly implemented features/functionality. Use this section .. for adoption of the newly implemented features/functionality. Use this section
.. to define tahe functions that must be available or any specific technical .. to define the functions that must be available or any specific technical
.. requirements that exist in order to successfully support your use case. If there .. requirements that exist in order to successfully support your use case. If there
.. are requirements that are external to OpenStack, note them as such. Please .. are requirements that are external to OpenStack, note them as such. Please
.. always add a comprehensible description to ensure that people understand your .. always add a comprehensible description to ensure that people understand your