System architecture induces document architecture

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.


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


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
Venue - Dates: The 20th International Conference on Software Engineering and Knowledge Engineering (SEKE 2008), 2008-07-01 - 2008-07-03
Organisations: Electronics & Computer Science
ePrint ID: 265679
Date :
Date Event
7 May 2008Published
Date Deposited: 07 May 2008 15:02
Last Modified: 17 Apr 2017 19:15
Further Information:Google Scholar

Actions (login required)

View Item View Item