How can I best document acceptance criteria for user stories?

I'm going to use JIRA/Greenhopper OnDemand on my Scrum agile project for story management and scheduling into sprints. What's the best place to put acceptance criteria? Should they just go in with the Description body, or should I create a new field?

6 answers

1 accepted

This widget could not be displayed.

I've just added them into the Description field under an Acceptance Criteria heading... not beautiful, but simple. Keeps all the detail for the developers together.

Hi John,

How did you add acceptance criteria in the Jira board, I'm new to Jira and was given admin access to it.

Hi, John is just saying that he put the Acceptace Criteria within the Description. Adding a header that says "Acceptance Criteria" within the Description field helps, visually speaking.

This widget could not be displayed.

We use an extra field "Acceptance criteria" because the description field is for understanding the user story.

The criteria geht the prefix (-) for not fullfilled and (/) for fullfilled. So we can visually check the progress of a story very easily.

When there are sub tasks, the sub tasks get the acceptance criteria and the user stories acceptance criteria are a brief summary of the total acceptance criteria divided in scections per sub task. When a sub task itself is an acceptance criterion this works well, too.

This way has stood the test of time in the last years.

This widget could not be displayed.

We have done two things. The DONE criteria is actually mapped to a set of fields in Jira so that developers need not go anywhere else to get reminded about the stuff they need to finish for any Story. Also an additional transistion is added to 'Under Progress' state, which opens up a customized screen for the DONE criteria stuff. This transistion does not change the status, it goes back to 'Under Development' itself. So once all the DONE criteria is met, it is ready for a closure. Also this makes the status transparent to people.

Additionally a more descriptive explaination of each criteria is put down in Confluence and under each of the custom field created in Jira, the description has a link to this page in Confluence for each field.

This widget could not be displayed.

What if your subtasks under the story were the acceptance criteria? That my work well also (I may try it out)....

This widget could not be displayed.

Just for future reference, there is a JIRA add-on called Checklist that allows a team to track their acceptance criteria in a checkbox form. It also offers a validator that prevent issue transitions until the criteria are validated.

Yet another paid plug-in that should be included with JIRA Agile.

This is the best option I have come across. You can either use the plugin or set it up yourself. Check the below page and it goes in depth about how to do this effectively.

This widget could not be displayed.

As a suggestion to this question, acceptence criterias should not be that difficult to use. Normally as Scrum Master , my expectation in story detail page is -

1- Explanation of the story.

2- A list where i can add acceptence criterias by just clicking a plus icon.

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Published Apr 22, 2018 in Jira Software

How-to setup a secured Jira Software 7.9.0 on Ubuntu 16.04.4 in less than 30 minutes

...PermissionsStartOnly=true User=www-data Group=www-data ExecStart=/opt/jira/bin/ ExecStop=/opt/jira/bin/ TimeoutStartSec=120 TimeoutStopSec=600 PrivateTmp=true [Install] WantedBy...

1,062 views 5 11
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you