Software Requirements 2

Category: Programming
Author: Karl Eugene Wiegers
4.5
All Stack Overflow 10

Comments

by anonymous   2017-08-20

I can sympathize...you're struggling with issues I think every software project does at some point or another. But time machine? Wow, if only. Though I don't know if having one would make things better or worse!

Karl Weigers has some good books on requirements.

Software Requirements: Practical Techniques for Gathering and Managing Requirements Throughout the Product Development Cycle.

A follow up he wrote called More About Software Requirements: Thorny Issues and Practical Advice is also good and tries to address common roadblocks.

Agilists, of course, will note that you can trigger more earnest feedback from users by showing them something earlier in the process, even a crude prototype.

by anonymous   2017-08-20

This article on Writing Quality Requirements would probably be worth the read. The end of the article has some general "Guidelines" that would probably be useful to you.

Among the guidelines are things like:

  • Keep sentences and paragraphs short
  • Use the active voice
  • Find the right level of granularity (requirements written should be individually testable)
  • Avoid writing multiple requirements in a single statement (conjunctions like "and" and "or" can help you spot this)

Lots of other good resources similar to the above article are available to help give you some perspective. If you're looking for a much more comprehensive look at requirements "best practices", check out Software Requirements, Second Edition (Amazon).