Abstract
Requirements documentation is essential for developing software systems of non-trivial size. The cost of creating and maintaining documentation artifacts in terms of time and effort is significantly influenced by the tools with which engineers view, navigate and edit documentation artifacts. However, there is not much evidence about how well documentation tools actually support engineers, particularly when dealing with artifacts that are larger than the available display screen and with multiple artifacts at the same time. Therefore, we conducted an exploratory study based on 29 interviews with software practitioners to understand the current practice of presenting and manipulating artifacts in documentation tools, and how practitioners deal with the challenges encountered. Our study shows that a significant number of artifacts cannot be viewed entirely, even on large screens. Moreover, more than half of the participants use four or more artifacts concurrently. Nevertheless, current tools only provide primitive capabilities for handling concurrent and large artifacts, thus forcing engineers to create, for example, mental images of the currently used artifacts or use workarounds such as hanging printouts to the wall. Our results may trigger new research and help improve requirements engineering tools.
Ghazi, Parisa