views:

3939

answers:

18

How do you go about the requirements gathering phase? Does anyone have a good set of guidelines or tips to follow? What are some good questions to ask the stakeholders?

I am currently working on a new project and there are a lot of unknowns. I am in the process of coming up with a list of questions to ask the stakeholders. However I cant help but to feel that I am missing something or forgetting to ask a critical question.

+3  A: 

You can never ask too many or "stupid" questions. The more questions you ask, the more answers you receive.

Robert Durgin
+13  A: 
Dillie-O
McConnell says, this kind of problems are quite common, and are called "wicked problems" (ie: ypu can describe them only by solving them).
smok1
+14  A: 

You're almost certainly missing something. A lot of things, probably. Don't worry, it's ok. Even if you remembered everything and covered all the bases stakeholders aren't going to be able to give you very good, clear requirements without any point of reference. The best way to do this sort of thing is to get what you can from them now, then take that and give them something to react to. It can be a paper prototype, a mockup, version 0.1 of the software, whatever. Then they can start telling you what they really want.

Chris Upchurch
So that, after you write the app, they can tell you that it's not really what they wanted after all.
Robert Harvey
+3  A: 

According to Steve Yegge that's the wrong question to ask. If you're gathering requirement it's already too late, your project is doomed.

Sam Hasler
wall of text detected at given url...tl/dr
Adam Bellaire
Yeah, Steve Yege has a reputation for writing long blog posts. See the following for his explanation for why he does it on purpose: http://steve-yegge.blogspot.com/2008/01/blogging-theory-201-size-does-matter.html (half as long as the one I link to in the answer, although that's still not short :)
Sam Hasler
I don't totally agree with Steve Yegge here (many commenters to his post didn't), but I think the essay is a useful read to those learning about requirement gathering. If you, personally, don't know how the thing is supposed to work or really care how it's supposed to work on a day-by-day personal basis, it's just not gonna work the way the customer wants it to. A tough pill to swallow, methinks.
sheepsimulator
+5  A: 

First of all gather the requirements before you start coding. You can begin the design while you are gathering them depending on your project life cicle but you shouldn't ever start coding without them.

Requirements are a set of well written documents that protect both the client and yourself. Never forget that. If no requirement is present then it was not paid for (and thus it requires a formal change request), if it's present then it must be implemented and must work correctly.

Requirements must be testable. If a requirement cannot be tested then it isn't a requirement. That means something like, "The system "

Requirements must be concrete. That means stating "The system user interface shall be easy to use" is not a correct requirment.

In order to actually "gather" the requirements you need to first make sure you understand the businness model. The client will tell you what they want with its own words, it is your job to understand it and interpret it in the right context.

Make meetings with the client while you're developing the requirements. Describe them to the client with your own words and make sure you and the client have the same concept in the requirements.

Requirements require concise, testable example, but keep track of every other thing that comes up in the meetings, diagrams, doubts and try to mantain a record of every meeting.

If you can use an incremental life cycle, that will give you the ability to improve some bad gathered requirements.

Jorge Córdoba
+1 on requirements being testable
Randell
+8  A: 

Steve Yegge talks fun but there is money to be made in working out what other people's requirements are so i'd take his article with a pinch of salt.

Requirements gathering is incredibly tough because of the manner in which communication works. Its a four step process that is lossy in each step.

  • I have an idea in my head
  • I transform this into words and pictures
  • You interpret the pictures and words
  • You paint an image in your own mind of what my original idea was like

And humans fuck this up constantly, through their adorable imperfections.

Agile does right in promoting iterative development. Getting early versions out to the client is important in identifying what features are most important (what ships in 0.1 - 0.5 ish), helps to keep you both on the right track in terms of how the application will work and quickly identifies the hidden features that you will miss.

The two main problem scenarios are the two ends of the scales:

  • Not knowing what the fuck you are doing - get some domain experts
  • Having too many requirements - feature pit. - Question, cull (prioritise ;) ) features and use iterative development

Yegge does well in pointing out that domain experts are essential to produce good requirements because they know the business and have worked in it. They can help identify the core desire of the client and will help explain how their staff will use the system and what is important to the staff. Alternatives and additions include trying to do the job yourself to get into the mindset or having a client staff member occasionally on-site, although the latter is unlikely to happen.

The feature pit is the other side, mostly full of failed government IT projects. Too much, too soon, not enough thought or application of realism (but what do you expect they have only about four years to make themselves feel important?). The aim here is to work out what the customer really wants. As long as you work on getting the core components correct, efficient and bug-free clients usually remain tolerant of missing features that arrive in later shipments, as long as they eventually arrive. This is where iterative development really helps.

Remember to separate the client's ideas of what the program will be like and what they want the program to achieve. Some clients can create confusion by communicating their requirements in the form of application features which may be poorly thought out or made redundant by much simpler functionality then they think they require. While I'm not advocating calling the client an idiot or not listening to them I feel that it is worth forever asking why they want a particular feature to get to its underlying purpose.

Remember that in either scenario it is of imperative importantance to root out the quickest path to fulfilling the customers core need and put you in a scenario where you are both profiting from the relationship.

Quibblesome
+1, your post exudes wisdom.
sheepsimulator
+2  A: 
  1. High-level discussions about purpose, scope, limitations of operating environment, size, etc

  2. Audition a single paragraph description of the system, hammer it out

  3. Mock up UI

  4. Formalize known requirements

  5. Now iterate between 3 and 4 with more and more functional prototypes and more specs with more details. Write tests as you go. Do this until you have functional software and a complete, objective, testable requirements spec.

That's the dream. The reality is usually after a couple iterations everybody goes head-down and codes until there's a month left to test.

Aidan Ryan
+1 on iterations
Randell
+1  A: 

There are some great ideas here already. Here are some requirements gathering principles that I always like to keep in mind:

Know the difference between the user and the customer. The business owners that approve the shiny project are usually the customers. However, a devastating mistake is the tendency to confuse them as the user. The customer is usually the person that recognizes the need for your product, but the user is the person that will actually be using the solution (and will most likely complain later about a requirement your product did not meet). Go to more than one person

Because we’re all human, and we tend to not remember every excruciating detail. You increase your likelihood of finding missed requirements as you talk to more people and cross-check.

Avoid specials When a user asks for something very specific, be wary. Always question the biases and see if this will really make your product better.

Prototype Don’t wait till launch to show what you have to the user. Do frequent prototypes (you can even call them beta versions) and get constant feedback throughout the development process. You’ll probably find more requirements as you do this.

I wrote a whole blog entry about how to improve your requirements gathering skills, you can check it out here: How to improve your requirements gathering skills.

Tawheed
A: 

I recently started using the concepts, standards and templates defined by the International Institute of Business Analysts organization (IIBA).

They have a pretty good BOK (Book of Knowledge) that can be downloaded from their website. They do also have a certificate.

whiz
+1  A: 

Gathering Business Requirements Are Bullshit - Steve Yegge

Josh Smeaton
+6  A: 

Wow, where to start?

First, there is a set of knowledge someone should have to do analysis on some projects, but it really depends on what you are building for who. In other words, it makes a big difference if you are modifying an enterprise application for a Fortune 100 corporation, building an iPhone app, or adding functionality to a personal webpage.

Second, there are different kinds of requirements.

  • Objectives: What does the user want to accomplish?
  • Functional: What does the user need to do in order to reach their objective? (think steps to reach the objective/s)
  • Non-functional: What are the constraints your program needs to perform within? (think 10 vs 10k simultaneous users, growth, back-up, etc.)
  • Business rules: What dynamic constraints do you have to meet? (think calculations, definitions, legal concerns, etc.)

Third, the way to gather requirements most effectively, and then get feedback on them (which you will do, right?) is to use models. User cases and user stories are a model of what the user needs to do. Process models are another version of what needs to happen. System diagrams are just another model of how different parts of the program(s) interact. Good data modeling will define business concepts and show you the inputs, outputs, and changes that happen within your program. Models (and there are more than I listed) are really the key to the concern you list. A few good models will capture the needs and from models you can determine your requirements.

Fourth, get feedback. I know I mentioned this already, but you will not get everything right the first time, so get responses to what your customer wants.

As much as I appreciate requirements, and the models that drive them, users typically do not understand the ramifications of of all their requests. Constant communication with chances for review and feedback will give users a better understanding of what you are delivering. Further, they will refine their understanding based on what they see. Unless you're working for the government, iterations and / or prototypes are helpful.

Jeffrey Davidson
+1  A: 

I've been using mind mapping (like a work breakdown structure) to help gather requirements and define the unknowns (the #1 project killer). Start at a high level and work your way down. You need to work with the sponsors, users and development team to ensure you get all the angles and don't miss anything. You can't be expected to know the entire scope of what they want without their involvement...you - as a project manager/BA - need to get them involved (most important part of the job).

Here's a good reference page to additional info: http://www.systemsguild.com/GuildSite/Guild/resources.html

meade
+1 on mind-mapping
Randell
+1  A: 
  • read the agile manifesto - working software is the only measurement for the success of a software project
  • get familiar with agile software practices - study Scrum , lean programming , xp etc - this will save you tremendous amount of time not only for the requirements gathering but also for the entire software development lifecycle
  • keep regular discussions with Customers and especially the future users and key-users
  • make sure you talk to the Persons understanding the problem domain - e.g. specialists in the field
  • Take small notes during the talks
  • After each CONVERSATION write an official requirement list and present it for approving. Later on it would be difficult to argue against all agreed documentation
  • make sure your Customers know approximately what are the approximate expenses in time and money for implementing "nice to have" requirements
  • make sure you label the requirements as "must have" , "should have" and "nice to have" from the very beginning, ensure Customers understand the differences between those types also
  • integrate all documents into the latest and final requirements analysis (or the current one for the iteration or whatever agile programming cycle you are using ... )
  • remember that requirements do change over the software life cycle , so gathering is one thing but managing and implementing another
  • KISS - keep it as simple as possible
  • study also the environment where the future system will reside - there are more and more technological restraints from legacy or surrounding systems , since the companies do not prefer to throw to the garbage the money they have invested for decades even if in our modern minds 20 years old code is garbage ...
YordanGeorgiev
A: 

i wrote a blog article about the approach i use:

http://pm4web.blogspot.com/2008/10/needs-analysis-for-business-websites.html

basically: questions to ask your client before building their website.

i should add this questionnaire sheet is only geared towards basic website builds - like a business web presence. totally different story if you are talking about web-based software. although some of it is still relavant (e.g. questions relating to look and feel).

  • LM
louism
A: 

Requirements Engineering is a bit of an art, there are lots of different ways to go about it, you really have to tailor it to your project and the stakeholders involved. A good place to start is with Requirements Engineering by Karl Wiegers:

http://www.amazon.com/Software-Requirements-Second-Pro-Best-Practices/dp/0735618798/ref=pd_bbs_sr_2?ie=UTF8&s=books&qid=1234910330&sr=8-2

and a requirements engineering process which may consist of a number of steps e.g.:

  • Elicitation - for the basis for discussion with the business
  • Analysis and Description - a technical description for the purpose of the developers
  • Elaboration, Clarification, Verification and Negotiation - further refinement of the requirements

Also, there are a number of ways of documenting the requirements (Use Cases, Prototypes, Specifications, Modelling Languages). Each have their advantages and disadvantages. For example prototypes are very good for elicitation of ideas from the business and discussion of ideas.

I generally find that writing a set of use cases and including wireframe prototypes works well to identify an initial set of requirements. From that point it's a continual process of working with technical people and business people to further clarify and elaborate on the requirements. Keeping track of what was initially agreed and tracking additional requirements are essential to avoid scope creep. Negotiation plays a bit part here also between the various parties as per the Broken Iron Triangle (http://www.ambysoft.com/essays/brokenTriangle.html).

Jon
A: 

IMO the most important first step is to set up a dictornary of domain-specific words. When your client says "order", what does he mean? Something he receives from his customers or something he sends to his suppliers? Or maybe both?

Find the keywords in the stakeholders' business, and let them explain those words until you comprehend their meaning in the process. Without that, you will have a hard time trying to understand the requirements.

ammoQ
+1  A: 

Like most stages of the software development process its iteration works best.

First find out who your users are -- the XYZ dept,

Then find out where they fit into the organisation -- part of Z division,

Then find out what they do in general terms -- manage cash

Then in specific terms -- collect cash from tills, and check for till fraud.

Then you can start talking to them.

Ask what problem they want you want to solve -- you will get an answer like write a bamboozling system using OCR with shark technoligies.

Ignore that answer and ask some more questions to find out what the real problem is -- they cant read the till slips to reconcile the cash.

Agree a real solution with the users -- get a better ink ribbon supplier - or connect the electronic tills to the network and upload the logs to a central server.

Then agree in detail how they will measure the success of the project.

Then and only then propose and agree a detailed set of requirements.

James Anderson
+1  A: 

I would suggest you to read Roger-Pressman's Software Engineering: A Practitioner's Approach

TheVillageIdiot
Ouch, the Amazon reviews of that book are brutal.
Richard Morgan