Error Messages in User Stories for Countries with a Language Barrier
HI Guys,
I am soon going to attend the certification and I have been walking around this website for about a week learning different things. One thing on which I need you guys to help me out is clearly understanding the use of error messages in user stories.
I have read your community articles and there are skewed opinions about. I read to the extent that the error handling should be a part of the "Acceptance Criteria" and saw a few examples as well. The examples were basically of 2 types.
A : With a reference to an error message and
B : With no reference to error messages
A : With a reference to an error message - In such examples the error criteria was defined and was pointing out to another document to get the exact error message.
Sample - If "Last Name" is blank, do not allow user to enter data in other fields; display an error message. (Refer to Exception document, section Registration 1.2 for message.)
B : With no reference to error messages - In such examples only the error criteria was defined with no reference to any document.
Now I have 2 questions for which I will highly be obliged for getting an answer from you guys.
Question 1 - Does this make any sense at all to create a separate document for error messages. IMO it clearly disrupts the principle of not focusing on comprehensive documentation?
Question 2 - Are we expecting the developers in the scrum team to be proficient enough in "English Language" and are expecting them to write the messages on their own ? There are may countries in which you will find that the product owners and the scrum master are proficient in "English" but the development team is not. So if they start writing the error messages then they would make a mess out of it. Example - they may write "Your detail not save" instead of writing " Your details could not be saved" . In such an event wont it make sense to write the actual error message in " Acceptance Criteria" ?
Question 3 - If we are saying that the error message should not be written in acceptance criteria then wont it create unnecessary iterations where the wrongly formatted messages could be corrected ? There could also be a possibility that the scrum team needs to speak to the PO every time they need to define an error message in an application. Wont it also make the task tough for a QA as he would have nothing to refer to?
I hope that I am not sounding stupid in asking these questions. Seeking your expert opinions please.
Regards
Prakash
If exception processing is part of the proper function of a PBI, then that behavior should be captured in that item's acceptance criteria.
Regarding your questions on how to manage error message content, look to the Scrum pillar of Transparency. What approach would support everyone's similar understanding of the story and how it should behave? What practices would help mitigate future confusion or misunderstanding about the PBI?
A user story is a placeholder for a conversation about a possible requirement. Either of the scenarios you describe might be appropriate for the story at different times in its life. The user story to be concerned about is the one which is not talked about and which does not evolve through collaboration.