Jun 30
2008

Top Ten Reasons You Don't Need a Requirements Document

Posted by Jon Erickson in Software Development Methodology and ManagementRequirementsArchitecture and DesignApplication Development

jerickson

As I said in Requirements Are Required Reading, the real reason I'm a stickler for requirements documents is that a little extra effort upfront means I have to talk to fewer people later on -- and recall, I'm basically anti-social, which means I don't like to talk to people even in the best of situations. Luckily, David De Witt was there to set me straight, with his Top 10 reasons why you don't need a requirements document when upgrading software.

As David explains:

Everyone knows it's a pain to create a requirements document, especially when all you're doing is upgrading an existing software application. The process is tedious, time consuming and potentially treacherous -- what happens if something is forgotten or omitted from the list and neither the business nor the vendor is willing to accept responsibility?

  1. Save time. Compiling a requirements document takes so much time. You have to talk to the people who collect data, input it and use it. Besides the time required just to talk to them, you'll have to compile the information, analyze it and then decide what you already know -- the old system is not as good as the upgrade will be.
  2. Save money. Well, time is money, so the time you save in point one, above, is money saved. Think short-term efficiency and productivity.
  3. An upgrade is a one-time expense. Look at the cost of the upgrade as an investment in the business and you'll have to consider your return on investment. Such a calculation requires you to consider how much more productive the organization will be with the upgrade -- and at what cost -- compared to the current application. This can open Pandora's box or a can of worms; it's your choice.
  4. Eliminates outside interference. More often than not, a good requirements document will involve an objective outsider, who will ask all kinds of questions: What do you use most? Who uses the data? What reports are necessary? What doesn't work as well as you'd like? What do you use in this system that must be in an upgrade? This can lead to too many suggestions for changes, too much anticipation about correcting shortcomings in the current version and too many cross-functional contradictions. And remember: too many cooks spoil the broth.
  5. Diverts your users' attention. Asking users what they want in an updated software application can be counter-productive. It takes their attention away from the real work they're doing and it forces them to think about what could be done better, faster or more efficiently on the updated version. That process takes time, costs money and could postpone installation while your software vendor makes the requested changes to make the program work the way our users want it to. See points 1 and 2 above.
  6. Users are very good at creating workarounds and desk drawer systems. If it's not broken, don't fix it, right? Your users know this system so well and they've used it for so long they've developed their own ways to manipulate the data and generate reports the business requires. By learning that your users have developed their own "features" -- an inevitable outcome of the requirements development process - you will be forced to ask some serious questions. Why the workaround or desk drawer system? What in the current system made either one a solution? Are these problems or situations addressed -- some might say resolved -- in the upgrade? How? Why? Or why not?
  7. Documentation is unnecessary. Let's take the bull by the horns on this one. If you're going to do a costly and time-consuming requirements document, you simply must compare the documentation for the old system with the documentation for the new system. What matches? What doesn't? Why? Why not? Reviewing the documentation also might tell you how some of the old functionalities have been changed, or omitted. Can your business live with those changes or without those functionalities? The answers to these thorny questions can take your eye off that impressive list of features in the upgrade. And once you start asking yourself "how can we use this or that feature?" instead of focusing on what your business requires of the software, you're on a slippery slope. Ignoring the questions, however, does provide a great opportunity for the business and your users to live and learn later.
  8. Listen to your vendor. The new version will be easier to maintain, the vendor says. And besides that, the vendor won't support the old version. Accept these promises on good faith, so your IT department won't be inconvenienced by costly and time-consuming maintenance - and your users will be able to use the upgrade (it's just a few tweaks to the old system they know so well, right?) with ease and confidence.
  9. Features are not requirements. Features that come with the update are free, aren't they? It's a no-brainer: even if you don't need them right away, who knows -- you might use them later, and you've already paid for them. On the other hand, you'll probably have to pay for specific functionalities you've identified in a requirements document. But remember: If the folks who must use all the "new and improved" features in the upgrade can't do their jobs because the features don't meet their requirements, the new upgrade won't work.
  10. Requirements are not features. Asking your users to identify all the features they like will simplify your task, for sure. But asking them to tell you what their requirements are won't make your job any easier at all -- see points 6, 7 and 8. Think of features as all the expensive options on a new car that has no battery -- they're nice to have but they're of no use until you can start the car and drive away. Such a situation creates new opportunities, however, for your users to create new workarounds and desk drawer systems, and that will help you justify the absence of a pesky requirements document.

Okay, it probably didn't take you as long as it took me to figure out that David was writing tongue-in-cheek. As it turns out, David De Witt is the Practice Director for Requirements Management at NueVista, a company that actually promotes best practices and requirements management. And I suspect David would be more than happy to send you a list of the top 10 reasons -- drawn from experience -- why you should prepare a requirements document before upgrading a software application. Just drop him a note at This e-mail address is being protected from spam bots, you need JavaScript enabled to view it .

 



Comments (0)Add Comment

Write comment
You must be logged in to a comment. Please register if you do not have an account yet.

busy

Get your FREE Subscription to Dr. Dobb’s Digest today!

Dobbs Code Talk Quick Poll

This time next year, your most important operating system (host and/or target) will be:

Look Who's Code Talking


Glen Thompson
City: Klaipeda

Stephen Constable
City: Crawley

Bala Subra
City: Ayer

Mike Riley
City: Naperville

conan dalton
City: paris

Justin Greenwood
City: Carmel

Dobbs Code Talk Tags

.NET abstraction Ada Adobe Agile Ajax algorithm Algorithmic complexity ALM Analogical reasoning Android Anecdotes Apple Application Development AppStore Architecture and Design ARM Artificial Intelligence Artificial Life Assembler Programming Audio files AVX AWK Banking Bazaar Best Practices Blender Books Brain computer interfacing Build C C Programming C Sharp Cartoon Category theory Cellular automata Clojure Cloud Computing Cobol Cocoa Coder Of The Month Cognition as compression Collaboration Common Process/Frameworks Compilers Computational humour Computational narrative Computational politics Computer Science Computers in art computing pioneers concurrency Conferences Consciousness research Contest Contest140 contests CPlusPlus crime CSharp D Programming Data Centers Databases Debugging Delphi Deployment design Design Patterns Digital Signal Processing Distributed Django Documentation DSL dynamic language Eclipse EDA education Emacs Embedded Systems Encryption engineering Erlang Etymology Excel exception handling Facebook Financial computing Five Questions Flash Flash Lite Flex Forth Fortran Fraud FreeBSD Fun Functional Programming gadgets Games Gender Git gnuplot Go Google Graphics GUI hardware Heron High School High-Performance Computing History Holographic reduced representations HTML5 Humanity Humour Hungarian Notation Identity Inkscape Innovation Intel Interview iPhone J2EE Java JavaFX JavaOne JavaScript language engineering Legal lex LINQ Linux Lisp Literate Programming Logic Programming m4 Mainframes Make Mathematica Mercurial Mesh messaging Metaprogramming Microsoft MID Miscellaneous Musings ML Mobile Software Mobility modeling modular programming multicore Music MVC myblog Natural Language Processing Networking Neural networks newspeak Nokia numerical computing Object Rexx ObjectiveC Office Office 2007 Online spreadsheets OOP Open Source Openaccess publishing OpenBSD OpenSolaris Operating Systems Optimization Oracle Pair Programming Parallelism Concurrency Parsing Pascal Patents Patterns Performance Perl PHP Podcast Pop11 Poplog Privacy Processing Productivity Programming Language Implementation Programming Language One Programming language semantics Programming Languages Programming Style Project Management Prolog Psychology Public understanding of science puzzle Python QA Quantum Computing Quotes Rails Realtime recls Requirements Research practice REST Review RIA rich internet applications Robotics Ruby SaaS Software as a service Scala Schadenfreude Science fiction Screencast Scripting SD Best Practices Search Security Semantic Web Silverlight Snobol SOA social Social Networks Society for the Study of Artificial Intelligence a Software Development Methodology and Management Songs and poems Spending Priorities Spreadsheets SQL Startups Statistics Storage String pattern matching Survey Teaching Testing The Business of Programming The Dobbs Challenge The Future Theory Topology Transhumanism Travel on the Job Twitter Types Unix Upgrade Usability Use Cases USENET User Experience User Interface Design Version Control video virtual machines Virtualization Visual Studio Visual Studio Sponsored Post WCF Web Development Windows Windows 7 Windows Live Wireless WOA WPF X Window System yacc

Subscribe to Dr. Dobbs Newsletter

Email:
Dr. Dobb's Update
Delivered twice a week, Dr. Dobb's Update provides unbiased and objective news, commentary and technical features spanning the entire software development marketplace.

Latest Comments

Jonathan's Last Day at Sun
For the 8 years I worked there, it was fantastic. I worked there under McNealy and I have undying admiration for the guy. I only knew Jonathan periphe...
Implementing Thread Local Storage on OS ...
Back in the day, I did a fair amount of work with PThreads. Wonderful design. Some quirks, but basically really, really nice. Although I wrote a lot ...
More Technonecrophilia with Snobol One-L...
Yeah, It's probably identical except for the (embedded) copy number, I would think. Once it became freely distributable, the copy I've been distribut...
More Technonecrophilia with Snobol One-L...
There's a spitbol-3.7-win.exe at http://code.google.com/p/spitbol/downloads/list . I found it via Dave Shield's blog page http://daveshields.wordpress...
Jonathan's Last Day at Sun
Sadness.

The Latest From Our Member Blogs

How To Select Trainees
Written by Joel Wiesen   
01/27/10
Hiring the right trainee can be harder than hiring a trained programmer.  One approach is described at my website: http://www.aprtestingservices.com/business/lpat/
 
Technical Job Interviews
Written by Keith Kerlan   
01/20/10
What is the best way to interview for software developer positions?  I've been on both sides of the job interviewing table, but have been on the interviewee side of some not too  great inter
 
Timers/timeouts in multi-threaded event-loops
Written by Christof Meerwald   
01/03/10
The traditional way to integrate timeout handling (or timers) in (single-threaded) event loops was to just pass the appropriate timeout value to the select/poll/epoll syscall. While this works fine
 
C vs C++
Written by Issam Lahlali   
12/04/09
I think that the debate "C vs C++" will end when the two langages died, and each one have its advantages and inconvenients, the choice of one instead of another depend on the application c
 
Great Jobs at CISCO
Written by Brent Rogers   
11/30/09
Hello! I am a recruiter at CISCO. We have a number of great jobopportunities at CISCO right now. Please take a look at the job links listedbelow and please send me an updated resume if you are interes
 
OK Labs, ST-Ericsson, and the Mobile/Wireless Ecosystem
Written by Steve Subar   
11/17/09
Two weeks ago, OK Labs and ST-Ericsson announced the selection of OK Labs as ST-Ericsson's mobile virtualization partner. To earn this coveted position, OK Labs prevailed in a rigorous evaluation
 
C++ Ninjas Needed in Santa Clara, California
Written by Brent Rogers   
09/30/09
Hello! I am a recruiter at CISCO. Our PostPath teamin Santa Clara is building a new Email SaaS business at CISCO. We are looking forsenior developers with Zimbra expertise to help us accomplish this t
 
Fighting Fragmentation with Mobile Virtualization
Written by Steve Subar   
09/21/09
Last week Motorola and T-Mobile announced the launch of a new and innovative Android-based smartphone, the Cliq. This attractive, feature-rich slider handset happens to build on a chipset and firmware
 
Insights into Router Design: Unit Testing of Networking Protocols
Written by Rajesh Kumar Venkateswaran   
09/07/09
  Unit testing is a software validation methodology through which a programmer tests individual modules or units of source code. If the programmer has been responsible for developing a networ
 
Insights into Router Design: Implementation of Networking Protocols
Written by Rajesh Kumar Venkateswaran   
09/06/09
  Modern data networking consists of a large number of networking protocols, each of which has its own domain of applicability. Some run on end stations (also called hosts), some on enterp
 
Insights and Innovations in Networking
Written by Rajesh Kumar Venkateswaran   
09/05/09
Networking devices such as routers and switches have evolved quite a bit over the past years, both in the service provider network and in the enterprise. It is a challenge to build these devices, bo
 
reddit threads community
Written by Christof Meerwald   
08/30/09
I have just started a threads community over at reddit to cover topics such as multithreading, concurrency and parallel programming. Feel free to join if you are interested. -- cmeerw.org 
 

The Latest From Dr. Dobbs

DDJ