|
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
|