Generate Pharo class comments automatically

Introduction

Developers refer to code documentation frequently when they need to understand source code to implement a new feature, or to maintain the existing code. In Pharo, class comments are a primary source of the code documentation. To guide developers to write class comments, Pharo provides a default class comment template. The template suggests various types of information. Rani et al. [Rani20a] found that developers frequently mention these template inspired information type compared to other information types found in the comments. However, there are often cases when developers write incomplete comments or do not write class comments due to time and effort constraints. We suggest that automatically generating the template inspired information types from the code can help developers in reducing the efforts. Moreno et al. [More13b] suggested a technique to generate the summaries for Java class automatically but adapting their approach to Pharo requires heavy adaption as the template proposed by them is different from the Pharo template.

Aim

In this project, we aim to explore the techniques to automatically generate the template inspired information and summarize the generated information to present in the class comment.

Steps

NB: Search the references in Scg bib

Further Material

Contact