Object-oriented documentation

  • Authors:
  • Johannes Sametinger

  • Affiliations:
  • -

  • Venue:
  • ACM SIGDOC Asterisk Journal of Computer Documentation
  • Year:
  • 1994

Quantified Score

Hi-index 0.00

Visualization

Abstract

Object-oriented programming improves the reusability of software components. Extensive reuse of existing software enhances the importance of documentation. To increase productivity in documenting and to make the structure of documentation better suitable for object-oriented software systems, we suggest applying object-oriented technology to the documentation, too. This makes it possible to reuse documentation by extending and modifying it without making copies and without making any changes to the original documentation. Additionally, interests of various groups of readers (for example, reusers and maintenance staff) can be taken into account, and easy access to relevant information can be given.In this paper, we briefly describe a documentation scheme for object-oriented software systems. This scheme distinguishes among overview, external view, and internal view of both static and dynamic aspects of software components. Then we apply inheritance by simply reusing and extending existing documentation where appropriate, and enforce information hiding by providing an access control mechanism. This improves the reusability and accessibility of documentation. Additionally, we present an exemplary tool and relate our experience with object-oriented documentation.