Software documentation and software maintenance.


Software maintenance includes activities like correcting faults in software systems, adapting systems to changing environments, or improving the quality of systems, e.g., performance. Software maintenance is usually done by people other than those who developed a software system. It requires detailed documentation and the possibility to attain an overview of the system structure, the interaction of the various components, and the effects of changes.
The main focus of this research project was to combine state-of-the-art methodologies in a new tool in order to improve the support of documentation and maintenance activities. Additional goals were to identify major problems in the field, to determine possible improvements, to investigate how these improvements were supported by tools, to summarize deficiencies of existing tools, and to ameliorate these deficiencies in the design of a new tool. The resulting tool, DOgMA, has served as a contribution to the improvement of the documentation and maintenance process.

Software Documentation and Maintenance

Publications

J. Sametinger, M. Riebisch: Evolution Support by Homogeneously Documenting Patterns, Aspects and Traces, 6th European Conference on Software Maintenance and Reengineering (CSMR 2002), Budapest, Hungary, March 11-13, 2002.
DOI: 10.1109/csmr.2002.995798
Conference Article
B. Childs, J. Sametinger, Documentation Inheritance in Literate Programs, Proceedings of White Object-Oriented Nights (WOON), St. Petersburg, Russia, June 20-21, 1996.
Conference Article
B. Childs, J. Sametinger, Literate Programming and Documentation Reuse, Proceedings of the 4th International Conference on Software Reuse, Orlando, Florida, April 1996
DOI: 10.1109/icsr.1996.496128
Conference Article
J. Sametinger, Reuse Documentation and Documentation Reuse, Proceedings of TOOLS Europe '96, Paris, February 1996.
Conference Article
J. Sametinger, S. Schiffer, Design and Implementation Aspects of an Experimental C++ Programming Environment, Software - Practice and Experience, Vol. 25, No. 2, pp. 111-128, February 1995.
DOI: 10.1002/spe.4380250202
Journal Article
J. Sametinger, Object-Oriented Documentation, Journal of Computer Documentation, Vol. 18, No. 1, pp. 3-14, January 1994.
DOI: 10.1145/181897.181898
Journal Article
J. Sametinger, The Role of Documentation in Programmer Training, Programming Languages: Experiences and Practice, Mark Woodman (Ed.), Chapman & Hall, 1994
Book Chapter
J. Sametinger, DOgMA: Ein Werkzeug zur Wartung objektorientierter Software in C++, F. Lehner (Hrsg.): Die Wartung von wissensbasierten Systemen, Verlag Deutsche Hochschulschriften, S. 202-232, Egelsbach, Frankfurt/Washington 1994, ISBN 3-85369-868-9.
Book Chapter
J. Sametinger, A. Stritzinger, A Documentation Scheme for Object-oriented Software Systems, OOPS Messenger, ACM Press, Vol. 4, No. 3, pp. 6-17, July 1993. DOI: 10.1145/165507.165513
Journal Article
G. Pomberger, T. Prückler, J. Sametinger, Documenting and Maintaining Modula-2 Programs with DOgMA, Proceedings of the Second European Modula-2 Conference, Leicester, England, September 8 - 9, pp. 201-211, 1992.
Conference Article
Johannes Sametinger: DOgMA: A Tool for the DOcumentation & MAintenance of Software Systems, Verband der wissenschaftlichen Gesellschaften Österreichs (VWGÖ), ISBN 3-85369-868-9, Wien 1992.
PhD Thesis
Johannes Sametinger: DOgMA: A Tool for the DOcumentation & MAintenance of Software Systems, Verband der wissenschaftlichen Gesellschaften Österreichs (VWGÖ), ISBN 3-85369-868-9, Wien 1992.
PhD Thesis
J. Sametinger, G. Pomberger, A Hypertext System for Literate C++ Programming, Journal of Object-Oriented Programming, Vol. 4, No. 8, pp. 24-29, SIGS Publications, New York, January 1992.
Journal Article
J. Sametinger, A. Stritzinger, Exploratory Software Development with Class Libraries, Shifting Paradigms in Software Engineering, R. Mittermeier (Ed.), Springer-Verlag, 1992. Proceedings of the 7th Joint Conference of the Austrian Computer Society (OCG) and the John von Neumann Society for Computing Sciences (NJSZT), Klagenfurt, 1992
DOI: 10.1007/978-3-7091-9258-0_4
Conference Article
J. Sametinger: Improving Program Comprehension of Object-Oriented Software Systems with Object-Oriented Documentation, Position Paper, Program Comprehension Workshop, Italy, 1992.
Workshop Article
J. Sametinger, A. Stritzinger: Ein Hypertext-Editor zur Software-Wartung, Proceedings of the Hypertext / Hypermedia '91 Conference, Graz, May 27 - 28, 1991, pp. 249-256, Springer-Verlag 1991.
DOI: 10.1007/978-3-642-76698-5_24
Conference Article
J. Sametinger: A Tool for the Maintenance of C++ Programs, Proceedings of the Conference on Software Maintenance, San Diego, CA, pp. 54-59, November 1990.
DOI: 10.1109/icsm.1990.131323
Conference Article
G. Blaschek, J. Sametinger: User-Adaptable Prettyprinting, Software - Practice and Experience, Vol. 19, No. 7, pp. 687-702, July 1989.
DOI: 10.1002/spe.4380190703
Journal Article