Home
 
Information
Sources

 
Training &
Seminars

 
About
Btt

 


 

 

Page 3 of 8

"Rich Requirement Specifications: the use of Planguage to clarify requirements"

 

Now let us look at the issue of relevance.

What if the requirement as stated represents at best only part of the constituency. One stakeholder, but not all. What if the requirement does not meet the needs of the main authority behind the need? What if the requirement is a misinterpretation of a stated stakeholder need? These and many similar considerations doom even a clear requirement to fail the test of relevance. Here is how the requirements language can help us discover such problems..

 

Reliability:

Owner: Quality Director

Status: Approved by Owner 17 November 2003.

Version: 17 December 2003.

Author: John Engineer

Stakeholders: {Users, Shops, Repair Centers}.

Scale: Mean Time Between Failure.

Goal: 20,000 hours.
 


Some of these parameters we met earlier, but now we can point out additional purposes, for relevance testing.

When we know the owner of a requirement is the Quality Director, who last approved a change 17 November, but we can see there is a new version later, we know we need to get the requirement owner to approve the change. If there is some question about the content we know that the first point of checking it out is with the author, who may admit it can be improved, or that they failed to realize something. If we wanted to check the relevance of the scale or the goal, we know we can analyze or speak to the listed stakeholders.
 

Reliability:

Owner: Quality Director

Author: John Engineer

Stakeholders: {Users, Shops, Repair Centers}.

Scale: Mean Time Between Failure.

Goal[Users]: 20,000 hours. <- Customer Survey, 2004

Goal[Shops]: 30,000 hours. <- Dixons Chain [Quality Director].
 


Most details should have an accompanying ‘source’ annotation; done here by a ‘<-‘ source arrow symbol.

The source information is primarily used in quality control and change processes, in order to know exactly where to check the specification. If you take a look at most people’s specifications you will find that source information at the detailed level is the exception, rather than the rule it should be. The source information indirectly tells us about levels of authority, and thus can be used to understand the priority of a requirement level.
 

Principle R3: The requirement should explicitly document its relationships to designs, tests, stakeholders, sources, use cases and all other interesting things
 
Reliability:

Owner: Quality Director

Author: John Engineer

Stakeholders: {Users, Shops, Repair Centers}.

Scale: Mean Time Between Failure.

Meter [Operations]: Automated Log.

Goal[Users]: 20,000 hours. <- Customer Survey, 2004

Test [Integration Testing]: 60,000 hours continuous minimum.

Goal[Shops]: 30,000 hours. <- Dixons Chain [Quality Director].

Test [Field Trials]: defined by Customers in their Contracts, Default: MTBF Test.

Design Proposal: Distinct Triple Voting Software <- JJ Architect.
 


more...
 
©Tom Gilb 2005 

 

Back to: System Development     Back (previous): Page 2 of 8 
 

Copyright © Biness Transition Technologies Ltd 2004.  A

ll Rights Copyright © Business Transition Technologies Ltd 2006.  All Rights Reserved.