What should a requirements document provide? - No Fluff Just Stuff

What should a requirements document provide?

Posted by: Venkat Subramaniam on July 25, 2006

Recently I had the opportunity to meet a group of requirements specialists.  They were interested in
learning about Agility from the point of view of requirements gathering.

They were keen on getting all the right requirements documented so the developers can have all they
need to get their work done.

Unfortunately, the more time and effort we spend up-front trying to get the requirement fully documented,
the more we will find ourselves failing at it. A better approach is to get the requirements documented at a
fairly high level, highlighting what you may thing as major and/or important features. Then you can delve into
details right before the implementation.

A great book to read in this area is Mike Cohn?s ?User Stories Applied.?

So, what do I expect from a requirements document. Rather than providing answer to all my questions, I
would like for it to help me ask the right questions when I am ready to delve into the implementation.

A great requirements document helps me not with right answers, but with right questions.

Venkat Subramaniam

About Venkat Subramaniam

Dr. Venkat Subramaniam is an award-winning author, founder of Agile Developer, Inc., creator of agilelearner.com, and an instructional professor at the University of Houston.

He has trained and mentored thousands of software developers in the US, Canada, Europe, and Asia, and is a regularly-invited speaker at several international conferences. Venkat helps his clients effectively apply and succeed with sustainable agile practices on their software projects.

Venkat is a (co)author of multiple technical books, including the 2007 Jolt Productivity award winning book Practices of an Agile Developer. You can find a list of his books at agiledeveloper.com. You can reach him by email at venkats@agiledeveloper.com or on twitter at @venkat_s.

Why Attend the NFJS Tour?

  • » Cutting-Edge Technologies
  • » Agile Practices
  • » Peer Exchange

Current Topics:

  • Languages on the JVM: Scala, Groovy, Clojure
  • Enterprise Java
  • Core Java, Java 8
  • Agility
  • Testing: Geb, Spock, Easyb
  • REST
  • NoSQL: MongoDB, Cassandra
  • Hadoop
  • Spring 4
  • Cloud
  • Automation Tools: Gradle, Git, Jenkins, Sonar
  • HTML5, CSS3, AngularJS, jQuery, Usability
  • Mobile Apps - iPhone and Android
  • More...
Learn More »