Forums for the Business Analyst

  Modern Analyst Forums  Business and Sy...  Requirements  How to avoid implementation details in a User Story
Previous Previous
Next Next
New Post 4/3/2017 2:20 AM
User is offline Vijit
1 posts
No Ranking

How to avoid implementation details in a User Story 

Hello to one and all.


I am writing a user story and have stumbled upon this problem of avoiding the implementation detail in it. I already have a UI design created for the project.


Say, for example, I am writing a story for the login functionality. The login has two textboxes and a button. As I cannot use the terms textbox & button, as they are HTML implementation details, then how do I write the story.

I have written the following lines:

The Login module should have the following options:

  • The module should have an option (textbox) to enter a username
  • The module should have an option (textbox) to enter a password
  • The module should have an option (textbox) to submit the login details

Also, I am using the term Login Module instead of Login Page as Page is an HTML term

As I come from a development background I find it difficult to wrap my head around the concept of staying away from the implementation detail.

I am also uncomfortable to use the term "should" in my user story, but I have been asked to use it instead of can, will, shall etc.

This is my first project and I am quite nervous. I have read a lot on requirement gather and am quite overwhelmed.

Can someone please guide me with the requirement process for the following:

  • Requirement template
  • Mapping and tracing requirement with User stories


I hope I was able to convey my problem. Any form of help will be appreciated. Thank you for reading.

New Post 4/17/2017 9:05 AM
User is offline Patrick Schmöllerl
3 posts
No Ranking

Re: How to avoid implementation details in a User Story 

Hi Vijit,

I am not a nativ speaker, but the words "textbox" or "Login Module" don't sound like implementation details to me. You obviously don't want to write: "As a user I want to call POST userLogin with the following request-parameters ...". That would be over the top :-)

If you should include details on the implementation in your user-story or strictly avoid it, depends on your project. In my experience it very often depends on the size of the project (how many people are in between your specification and the developer) or your precise role (vgl.

However, there is a a part of a user-story called the"Conversation".This is the best place to add further implementation details (vgl.

New Post 5/11/2017 12:34 AM
User is offline Kimbo
431 posts
5th Level Poster

Re: How to avoid implementation details in a User Story 

Hi Vijit,

Don't stress too much about using solution in a user story. Your acceptance criteria will be hard to write if you do. Are you concerned because the end solution is not decided? 

If your solution includes other channels for login e.g. fingerprint, iris scan; you'll need separate user stories anyway. If not, then you'll need text boxes and buttons and stuff.


Previous Previous
Next Next
  Modern Analyst Forums  Business and Sy...  Requirements  How to avoid implementation details in a User Story

Community Blog - Latest Posts

Limor Wainstein
Limor Wainstein
Business analysts typically gather and interpret data from many areas within an organization, finding solutions to business problems and improving business processes with all that data. A business analyst may measure and improve on such disparate things as warehouse efficiency and cloud software implementation. A marketing analyst, on the other...
3 Responses
EA Learning
EA Learning
My current, favourite question for Executives and Architects is “How do you see Architecture operating in an Agile environment.” This question usually elicits a wry smile and a response along the lines of “I will need to get back to you on that!” Many people are wondering how Architecture will fair in the world of Agile. My ...
0 Responses
Limor Wainstein
Limor Wainstein
The age of cloud computing is now so firmly established that research firm Gartner predicted by 2020, a corporate "no-cloud" policy will be as rare as a "no-internet" policy is today. In the same press release, Gartner went on to predict that spending on compute power sold by cloud providers will exceed that of compute power sold and deployed into ...
0 Responses

Upcoming Live Webinars

Latest Articles

5 Business Analysis Trends to Watch in 2018
Jan 14, 2018
Given the speed of change, it is really tricky to predict what trends will grow in popularity or relevance. I am sure whatever emerges will seem obvio...
Featured Digital Library Resources 
Copyright 2006-2015 by Modern Analyst Media LLC