A Study of Architectural Information Foraging in Software Architecture Documents
Date
2012
Authors
Su, Moon
Tempero, Ewan
Hosking, John
Grundy, John
Journal Title
Journal ISSN
Volume Title
Publisher
IEEE Computer Society
Abstract
When using Software Architecture documents (ADs), users typically "forage" for information. However, it is little understood how they do this foraging or how to structure architecture documentation to assist them. We conducted a survey of two different groups of foragers, industry practitioner and academic AD users, to investigate issues - types of forages, foraging sequences and styles - related to task-based architectural information foraging in software architecture documents. Our results show that there were different pre-conceived ideas of what to forage for prior to the search, but during foraging there was commonly foraged information. The different groups of foragers place different emphasis on information related to quality requirements, purpose of the system, use cases, physical view and process view. Foraging sequences starting with certain information were suggested to better support understanding of the described SA. These sequences typically followed the written order of the information as dictated by the AD producers. This reinforces the critical responsibility of AD producers to structure the architectural information for understanding. Diagrams, views and design decisions were most frequently cited as supporting understanding of the SA. The main hindrance was too much text and a lack of diagrams.
Description
Keywords
Keywords: Design decisions; foraging; Information foraging; Process view; Quality requirements; Task-based; understanding; Natural resources exploration; Software architecture exploration; foraging; software architecture document; understanding
Citation
Collections
Source
2012 Joint Working IEEE/IFIP Conference onSoftware Architecture (WICSA) and European Conference on Software Architecture (ECSA)
Type
Conference paper