From Transient Information to Persistent Documentation: Enhancing Software Documentation

Abstract

Developers usually need to use different kinds of tools in the software development process, e.g., version control systems, code review tools, and bug or issue tracking systems. Some of those tools provide an enhanced approach for developers to communicate, i.e., discussions are recorded in the communication feature of those tools. There is important information, i.e., discussions and decisions, registered by those tools which are not propagated to the project documentation: the transient information. Thus, this work investigates how to improve the software documentation by making such transient important information into persistent documentation as source code comments. The results are relevant because they will aid the comprehension of the source code not only during the development process, but also in code reviews.

Publication
The 36th IEEE International Conference on Software Maintenance and Evolution (ICSME)
Felipe Ebert
Felipe Ebert
Postdoctoral Researcher

My research interests are related to how software systems and developers interact with each other. I’m interested in both technical and social aspects of software maintenance, specifically code reviews, mining software repositories, and also social development aspects. In the past, I also have worked with error handling and software energy consumption.

Related