International Conference on Modelling Techniques and Tools for Computer Performance Evaluation

TOOLS 2012: Objects, Models, Components, Patterns pp 320-335

Elucidative Development for Model-Based Documentation

  • Claas Wilke
  • Andreas Bartho
  • Julia Schroeter
  • Sven Karol
  • Uwe Aßmann
Conference paper

DOI: 10.1007/978-3-642-30561-0_22

Volume 7304 of the book series Lecture Notes in Computer Science (LNCS)
Cite this paper as:
Wilke C., Bartho A., Schroeter J., Karol S., Aßmann U. (2012) Elucidative Development for Model-Based Documentation. In: Furia C.A., Nanz S. (eds) Objects, Models, Components, Patterns. TOOLS 2012. Lecture Notes in Computer Science, vol 7304. Springer, Berlin, Heidelberg

Abstract

Documentation is an essential activity in software development, for source code as well as modelling artefacts. Typically, documentation is created and maintained manually which leads to inconsistencies as documented artefacts like source code or models evolve during development. Existing approaches like literate/elucidative programming or literate modelling address these problems by deriving documentation from software development artefacts or vice versa. However, these approaches restrict themselves to a certain kind of artefact and to a certain phase of the software development life-cycle. In this paper, we propose elucidative development as a generalisation of these approaches supporting heterogeneous kinds of artefacts as well as the analysis, design and implementation phases of the software development life-cycle. Elucidative development links source code and model artefacts into documentation and thus, maintains and updates their presentation semi-automatically. We present DEFT as an integrated development environment for elucidative development. We show, how DEFT can be applied to language specifications like the UML specification and help to avoid inconsistencies caused by maintenance and evolution of such a specification.

Keywords

Elucidative programming literate programming literate modelling automated documentation automated specification UML 

Preview

Unable to display preview. Download preview PDF.

Unable to display preview. Download preview PDF.

Copyright information

© Springer-Verlag Berlin Heidelberg 2012

Authors and Affiliations

  • Claas Wilke
    • 1
  • Andreas Bartho
    • 1
  • Julia Schroeter
    • 1
  • Sven Karol
    • 1
  • Uwe Aßmann
    • 1
  1. 1.Institut für Software- und MultimediatechnikTechnische Universität DresdenDresdenGermany