TY - GEN
T1 - A theory of requirements documentation situated in practice
AU - Power, Norah
AU - Moynihan, Tony
PY - 2003
Y1 - 2003
N2 - This paper presents a theoretical framework which attempts to explain the variety of styles of requirements documentation found in practice in relation to the variety of situations in which software products and systems are developed. It identifies situational factors that might be useful to categorize development situations from the point of view of the requirements documentation process. This framework is in contrast with much of the literature on requirements engineering, which takes a very prescriptive approach to documentation, and which takes very little account of the situation of use. The research was based on a qualitative study of requirements practitioners and their documentation practices. The empirical data collected from interviews in the study was systematically analyzed using the grounded theory method and a computer-based tool, ATLAS.ti. The framework is in three parts. The first part is an analysis of requirements documents as texts, categorizing the different constituent elements that might be used to specify requirements. The second part is a scheme for classifying system development situations with respect to the requirements documentation process. The third part of the framework takes each of these situation types and matches it with an appropriate style of requirements document that is found to be typical in that situation. The aim of the paper is to explain (or structure an explanation of) the diverse ways that system and software requirements are documented in practice. To date, this diversity has not been examined by any empirical study or theoretical framework. Most requirements specification techniques are regarded as application- independent, assumed to be context-independent, and presented as if they were universally applicable. Requirements specification standards follow a similar line. The paper concludes that standard prescriptive approaches have failed to identify the necessary and sufficient contents and style of a requirements document, because what is good enough in one situation may not be desirable or acceptable in another.
AB - This paper presents a theoretical framework which attempts to explain the variety of styles of requirements documentation found in practice in relation to the variety of situations in which software products and systems are developed. It identifies situational factors that might be useful to categorize development situations from the point of view of the requirements documentation process. This framework is in contrast with much of the literature on requirements engineering, which takes a very prescriptive approach to documentation, and which takes very little account of the situation of use. The research was based on a qualitative study of requirements practitioners and their documentation practices. The empirical data collected from interviews in the study was systematically analyzed using the grounded theory method and a computer-based tool, ATLAS.ti. The framework is in three parts. The first part is an analysis of requirements documents as texts, categorizing the different constituent elements that might be used to specify requirements. The second part is a scheme for classifying system development situations with respect to the requirements documentation process. The third part of the framework takes each of these situation types and matches it with an appropriate style of requirements document that is found to be typical in that situation. The aim of the paper is to explain (or structure an explanation of) the diverse ways that system and software requirements are documented in practice. To date, this diversity has not been examined by any empirical study or theoretical framework. Most requirements specification techniques are regarded as application- independent, assumed to be context-independent, and presented as if they were universally applicable. Requirements specification standards follow a similar line. The paper concludes that standard prescriptive approaches have failed to identify the necessary and sufficient contents and style of a requirements document, because what is good enough in one situation may not be desirable or acceptable in another.
KW - Documents
KW - Framework
KW - Practice
KW - Requirements
KW - Situations
UR - http://www.scopus.com/inward/record.url?scp=14544298242&partnerID=8YFLogxK
U2 - 10.1145/944885.944887
DO - 10.1145/944885.944887
M3 - Conference contribution
AN - SCOPUS:14544298242
SN - 158113696X
SN - 9781581136968
T3 - ACM Special Interest Group for Design. of Commun.; SIGDOC 2003: Finding Real-World Solutions for Doc.: How Theory Informs Pract. and Pract. Informs Theory. Proc. of the 21st Annu. Int. Conf. on Doc.
SP - 86
EP - 92
BT - ACM Special Interest Group for Design of Commun.; SIGDOC 2003
PB - Association for Computing Machinery (ACM)
T2 - ACM Special Interest Group for Design of Communications; SIGDOC 2003: Finding Real-World Solutions for Documentation: How Theory Informs Practice and Practice Informs Theory. proceedings of the 21st Annual International Conference on Documentation
Y2 - 12 October 2003 through 15 October 2003
ER -