I would like to propose a change in our GH templates, especially to our stories and tech debt issues.
Currently we have an acceptance criteria section that is either never added (because people use the feature template to create stories) or things added there are vague like “this page should work as usual” ).
We tend to go along with this because with time we know each other and the tool, so we read between the lines. But new dev and tester don’t have this knowledge and need to be guided.
Today as a tester I have 2 problems when I test a story:
Knowing which page we are talking about. Even recently we spoke a lot about Bulk Edit product page. I never noticed that this was the
admin/productspage English title so it took me a while to understand what was going on.
Understanding the scope of the story. Even with mockups, we don’t have the whole user journey described in our issues. So sometimes dev are making choices and I have no idea as a tester if the PO is happy with this or not. A tester shouldn’t have to ask things to the product owner at the testing stage. It is way too late.
Point 2 here is not a problem when we open Bugs, because we have this very useful section of “Steps to reproduce”, which I absolutely love.
So my major proposal here is to bring these steps to reproduce to the story template as well, as acceptance critera.
I have made an example here: https://github.com/openfoodfoundation/openfoodnetwork/issues/3859
What I like about this habit - with a product point of vue - is that often it helps me see what I’ve forgotten during inception. It is not perfect, in this example here I forgot to specify where the super admin could turn the invoice ON/OFF. A mockup would have been useful in this example. Notice also I used the sentence “as usual” there, so when I say we must improve our stories description I’m talking to myself as well And maybe it means a review among product people should be added before we start to develop something?
I also believe detailed steps are helping a tester who is not a user to test admin issues. Of course, while developing, a dev will see that other areas need to be tested and can add tests steps to these scenarios for the tester. But at least the initial scope is clearer for everyone.
If we go forward with automated testing it would also help us to feed automated tests.
Notice also I used link/URL rather than page name. It is really helpful, especially again to be sure of which pages we are talking about.
Finally, I would like to propose to drop the feature template on GH and keep it only in discourse. We put this content in epics but we don’t use it at all. We close epics when their linked issues are done, regardless of the success factors. And I don’t think this is a problem. A generic definition of an epic is a group of stories.
As we described in our process here: https://docs.google.com/presentation/d/1El3DjdwqthQYiJ3i1DkyzQlVnzS49omfjO12Ib5tDFA/edit#slide=id.g47c412a157_2_8 we review if we meet the need in discourse. The success factors can be reviewed in discourse only not both in GH and Discourse.
This would help to have only one template to describe stuff.
If I sum up my proposal in actions:
- Start adding steps to our acceptance criteria
- Start adding URL instead of page name
- Add acceptance criteria to tech debt issues
- Delete the feature template
I f you have other ideas on how to improve our stories, please share!