Mismar: A New Approach to Developer Documentation

  • Authors:
  • Barthelemy Dagenais;Harold Ossher

  • Affiliations:
  • McGill University, Canada;IBM T.J. Watson Research Center, USA

  • Venue:
  • ICSE COMPANION '07 Companion to the proceedings of the 29th International Conference on Software Engineering
  • Year:
  • 2007

Quantified Score

Hi-index 0.00

Visualization

Abstract

Successful open source projects foster collaboration and innovation while benefiting from a faster pace of development, but are often plagued by poor developer's documentation. In this paper, we present the rationale and the architecture of Mismar, a toolset tightly integrated in the Eclipse environment and implementing a concern-oriented approach to documentation. As opposed to traditional documentation artifacts, guides produced by Mismar are almost wordless and automatically maintain implementation examples. Moreover, since Mismar was built from the ground up to be extensible, it is easy to support artifacts written in multiple languages or modeling approaches.