A theory of requirements documentation situated in practice

Norah Power, Tony Moynihan

Research output: Chapter in Book/Report/Conference proceedingConference contributionpeer-review

Abstract

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.

Original languageEnglish
Title of host publicationACM Special Interest Group for Design of Commun.; SIGDOC 2003
Subtitle of host publicationFinding Real-World Solutions for Doc.: How Theory Informs Pract. and Pract. Informs Theory. Proc. of the 21st Annu. Int. Conf. on Doc.
PublisherAssociation for Computing Machinery (ACM)
Pages86-92
Number of pages7
ISBN (Print)158113696X, 9781581136968
DOIs
Publication statusPublished - 2003
EventACM 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 - San Francisco, CA, United States
Duration: 12 Oct 200315 Oct 2003

Publication series

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

Conference

ConferenceACM 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
Country/TerritoryUnited States
CitySan Francisco, CA
Period12/10/0315/10/03

Keywords

  • Documents
  • Framework
  • Practice
  • Requirements
  • Situations

Fingerprint

Dive into the research topics of 'A theory of requirements documentation situated in practice'. Together they form a unique fingerprint.

Cite this