A common failing in a requirements document is a lack of specifics: suppose it states something like
"A character starts at their maximum health value and takes damage each time it is struck
with a weapon (sword, dagger, or arrow)."
Somewhere (perhaps here, perhaps in a table elsewhere, but somewhere)
the requirements need to specify exact values for every aspect:
exactly what is the starting health? how much damage is
inflicted by a sword blow? by a dagger blow? by an arrow? If there are modifiers that
influence the damage then precisely what are they and precisely how is the modified
damage calculated?
After producing a first draft of the requirements have everyone read through the document looking
for places where it mentions a value or feature or calculation without precisely stating the
range of permissible values, the default value, a precise formula for the calculation,
the behaviour expected in case of errors, etc.
|