ICPC 2024
Sun 14 - Sat 20 April 2024 Lisbon, Portugal
co-located with ICSE 2024

The Most Influential Paper Award is presented to the author(s) of the paper from the ICPC meeting 10 years prior (from ICPC 2014) that is judged to have had the most influence on the theory or practice of Program Comprehension during the 10 years since its original publication.


Automatic documentation generation via source code summarization of method context

Paul W. McBurney, Collin McMillan


A documentation generator is a programming tool that creates documentation for software by analyzing the statements and comments in the software's source code. While many of these tools are manual, in that they require specially-formatted metadata written by programmers, new research has made inroads towards automatic generation of documentation. These approaches work by stitching together keywords from the source code into readable natural language sentences. These approaches have been shown to be effective, but carry a key limitation: the generated documents do not explain the source code's context. They can describe the behavior of a Java method, but not why the method exists or what role it plays in the software. In this paper, we propose a technique that includes this context by analyzing how the Java methods are invoked. In a user study, we found that programmers benefit from our generated documentation because it includes context information.