Documentation (BRD/SRS)

Posts about documenting requirements and different document types

The Magic of 7-9

If you recall from psychology 101, most people can only hold 7-9 items in their short term memory. To learn more pieces of information, you need to transfer those items to your long term memory. There are two ways that you can do this, either by rote memorization or by …

Read More

What Is the Right Level of Detail?

A couple of weeks ago I presented an overview of More About Software Requirements – Thorny Issues and Practical Advice by Karl Wiegers. Today, I am going to drill down a little bit further into one of the sections that I thought was particularly well done. Part V of the …

Read More

Requirements Documentation Standards

We use a set of requirements documentation standards to generate consistency in our writing styles. They should be applied to the documentation produced in the requirements phase of a project, including the requirements, use cases, diagrams and process flows. Instead of writing in individual preferred styles, the entire team writes …

Read More

The art and science of disambiguation

Jeff Gray reports in his Collection of Ambiguous or Inconsistent/Incomplete Statements that “the 500 words used most in the English language each have an average of 23 different meanings.” I think there are few times in life when you better grasp this fact than when you are either writing software …

Read More

Making sure your spec is reviewed.

Do you ever get the uneasy feeling that no one is reading your software requirements specification? The reality is that the development team is probably busy on the last release and that the business stakeholders are busy doing their jobs in the business. What is a lonely Product Manager to …

Read More

Shall we require – part 2

I was reading through some of our older blog postings and saw the Shall we require post. Joy had asked the question of why use shall and there is a comment by Melissa about the confusion of using will and must. One point of view on this was presented at …

Read More

Documented Requirements ARE Necessary

It all started with the recent CIO article Fixing the Requirements Mess. A comment by Christopher Creel (halfway down the page) was then put on the Requirements Defined Message Board. After reading Mr. Creel’s comments, and the other postings, I think people are missing the main problem with his argument. …

Read More

Cnotxet is ciritacl

I came across this the other day. It is a meme that has been making its way around the net for the past couple of years and purports to show how the mind is able to make sense out of jumbled words as long as the first and last letters …

Read More

Is it possible to overemphasize functional requirements?

Roger Cauvin had an interesting post the other day where he stated that “most organizations place too much emphasis on functional requirements.” The following day he expanded on this position by concluding that the overemphasis on functional requirements is detrimental to product development because “it shows the product manager dipped …

Read More