The University of Southampton
University of Southampton Institutional Repository

System architecture induces document architecture

Record type: Conference or Workshop Item (Paper)

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.

PDF SEKE_paper_181.pdf - Author's Original
Download (79kB)

Citation

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

More information

Published date: 7 May 2008
Additional Information: Event Dates: 1-3 July 2008
Venue - Dates: The 20th International Conference on Software Engineering and Knowledge Engineering (SEKE 2008), 2008-07-01 - 2008-07-03
Organisations: Electronics & Computer Science

Identifiers

Local EPrints ID: 265679
URI: http://eprints.soton.ac.uk/id/eprint/265679
PURE UUID: 6036d3eb-a30b-4b23-b49b-8ec4460daae5

Catalogue record

Date deposited: 07 May 2008 15:02
Last modified: 18 Jul 2017 07:24

Export record

Contributors

Author: Peter Henderson
Author: Nishadi De Silva

University divisions


Download statistics

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

Atom RSS 1.0 RSS 2.0

Contact ePrints Soton: eprints@soton.ac.uk

ePrints Soton supports OAI 2.0 with a base URL of http://eprints.soton.ac.uk/cgi/oai2

This repository has been built using EPrints software, developed at the University of Southampton, but available to everyone to use.

We use cookies to ensure that we give you the best experience on our website. If you continue without changing your settings, we will assume that you are happy to receive cookies on the University of Southampton website.

×