In the scope of DocGen2, the Second Software Documentation Generation Challenge, hosted by ICSME 2020.
The goal of the DeClutter challenge is to build an automated tool that can identify unnecessary software
documentation at the class or file level. For example, a comment saying //loop from 1 to N
just before code implementing
exactly that is not helpful, and worse, could drift when the underlying code is changed to (N-1) (for example). As such, it is considered as non-informative and labeled as "Non-information = Yes".
The tool should take in a CSV file in the described format, and output a label for each row as either "Non-information = Yes" for clutter, non-informative comments and "Non-information = No" for non-clutter ones.
In this study, we label as Non-information the comments that contain only non-information sentences. As such, the final criterion for annotation of non-information is defined as follows: “non-information is a comment that is completely uninformative and hence useless/should be removed (in the perspective of documentation decluttering)”.
Our definition grounds on the CADO guidelines for Content Analysis for Software Documentation, which defines as non-information "any complete sentence or self-contained fragment of text that provides only uninformative boilerplate text". Among examples, simply restating the name of the API element without adding any detail, or stating the obvious, or simply restating the information in the rest of the code block" (Maleej and Robillard, TSE 2013).
Our annotation unit is the entire comment. Consistently with the CADO guidelines, if a comment contains both uninformative and informative sentences, we consider that the uninformative part of the sentence is only context for the informative part, and we rate the comment as 'Non-information = No' (i.e., the comment is informative).
Both development and test data are distributed as CSV with UTF-8 encoding. in the following format “id, type, path_to_file, begin_line, link_to_comment, comment, non-information”
"FR974";"Line";"https://github.com/nnovielli/jabref/blob/master/src/main/java/org/jabref/gui/maintable/CellFactory.java";95;"https://github.com/nnovielli/jabref/blob/master/src/main/java/org/jabref/gui/maintable/CellFactory.java#L95";"icon.setToolTipText(printedViewModel.getLocalization());";"yes"
The Development dataset train_set_0520.csv contains 1311 rows and the 7 columns described above. Note: this dataset replaces declutter-gold_DevelopmentSet.csv (adding 261 new datapoints).
All entries will be submitted and ranked via the Kaggle data science platform. Tools will be ranked according to commonly accepted text classification scoring, e.g. Accuracy, Precision, Recall, Matthews Correlation. We may also award a prize for the tool which does best in some hitherto unappreciated dimension. DeClutter will be run as automatically as possible, using Kaggle as a leaderboard mechanism. This is a great opportunity for new researchers to get involved in the topic. The Kaggle contest is located at https://www.kaggle.com/c/declutter20v2/overview/.
Participants (either teams or individuals) will initially have access to the development data only. Later, the unlabelled test data will be released (see the timeline below). After the assessment, the labels for the test data will be released as well. Both development and test data will be extracted from the JabRef project. However, participants might use additional labeled data from other sources in order to develop and implement their systems. Guidelines describing the annotation and providing detailed instructions for participants will be released with the development data.
After submitting the predictions for the test data, participants will be required to provide a short report including a brief description of their approach, an illustration of their experiments, in particular techniques and resources used (included additional data used for building the model, if any), and an analysis of their results. Formatting guidelines will be released with the test data.
We invite the potential participants to register using the web form. Registration is compulsory to participate in the challenge, although it is not binding. In any case, independently of your registration, you can decide to withdraw from participating by not sending the system results during the evaluation stage. When registering, you will also have the option to subscribe to the Google group we will create to keep participants up to date with the latest news related to the challenge. Participants are encouraged to share comments and questions with the mailing list. The challenge co-chairs will assist you for any potential issues that could be raised.
Timeline for the DeClutter Challenge
- 15th November 2019: Development data available to participants
- 20th May 2020: Test data available
- 28th Aug 2020: Kaggle competition closes
Report submission deadlines
- 31st July 2020: Submission deadline for reports
- 14th August 2020: Notification deadline
- 28th August 2020: Camera-ready deadline (tentative)
- September 2020: Workshop co-located with ICSME 2020
Nicole Novielli, University of Bari, Italy
Neil Ernst, University of Victoria, Canada
If you have any questions, please contact the challenge chairs.
The challenge dataset is licensed under a Creative Commons Attribution 4.0 International License.