System architecture induces document architecture


Henderson, Peter and De Silva, Nishadi (2008) System architecture induces document architecture. In, The 20th International Conference on Software Engineering and Knowledge Engineering (SEKE 2008), San Francisco, 01 - 03 Jul 2008.

Download

[img] PDF - Submitted Version
Download (78Kb)

Description/Abstract

The documentation of an architecture is as important as the architecture itself. Tasked with communicating the structure and behaviour of a system and its constituent components to various stakeholders, the documentation is not trivial to produce. It becomes even harder in open, modular systems where components can be replaced and reused in each progressive build. How should documenta-tion for such systems be produced and how can it be made to easily evolve along with the system it describes? We propose that there is a close mapping between the system architecture and its documentation. We describe a rela-tional model for the architecture of open systems, paying close attention to the property that certain components can be reused or replaced. We then use ideas from storytelling and a discourse theory called Rhetorical Structure Theory (RST) to propose a narrative-based approach to architec-ture documentation; giving both a generic narrative tem-plate for component descriptions and a RST-based rela-tional model for the document architecture. We show how the two models (system and documentation) map onto each other and use this mapping to demonstrate how document fragments can be stored, automatically extracted and col-lated to closely reflect the system’s architecture.

Item Type: Conference or Workshop Item (Paper)
Additional Information: Event Dates: 1-3 July 2008
Divisions: Faculty of Physical Sciences and Engineering > Electronics and Computer Science
ePrint ID: 265679
Date Deposited: 07 May 2008 15:02
Last Modified: 27 Mar 2014 20:10
Further Information:Google Scholar
URI: http://eprints.soton.ac.uk/id/eprint/265679

Actions (login required)

View Item View Item

Downloads from ePrints over the past year. Other digital versions may also be available to download e.g. from the publisher's website.

View more statistics