A New Dataset for Source Code Comment Coherence

نویسندگان

  • Anna Corazza
  • Valerio Maggio
  • Giuseppe Scanniello
چکیده

English. Source code comments provide useful insights on a codebase and on the intent behind design decisions and goals. Often, the information provided in the comment of a method and in its corresponding implementation may be not coherent with each other (i.e., the comment does not properly describe the implementation). Several could be the motivations for this issue (e.g., comment and source code do not evolve coherently). In this paper, we present the results of a manual assessment on the coherence between comments and implementations of 3, 636 methods, gathered from 4 Java open-source software. The results of this assessment has been collected in a dataset that we made publicly available on the web. We also sketch here the protocol to create this dataset. Italiano. I commenti al codice sorgente forniscono informazioni utili sull’implementazione del codice e sulle intenzioni relative alle decisioni e agli scopi del progetto. Spesso, le informazioni presenti nel commento di un metodo e nella sua implementazione possono non essere coerenti (nel senso che il commento non dà una descrizione adeguata dell’implementazione). Ci possono essere diverse spiegazioni per questo (ad esempio, commenti e codice sorgente non sono stati modificati in modo coerente). In questo articolo, presentiamo i risultati di una valutazione manuale della coerenza tra commenti e implementazione di 3, 636 metodi, raccolti da 4 applicazioni open source in Java. I risultati di questa valutazione sono stati raccolti in un dataset che abbiamo pubblicato sul web. Accenniamo anche al protocollo seguito per la preparazione del dataset.

برای دانلود متن کامل این مقاله و بیش از 32 میلیون مقاله دیگر ابتدا ثبت نام کنید

ثبت نام

اگر عضو سایت هستید لطفا وارد حساب کاربری خود شوید

منابع مشابه

Next Steps for Elevating Health on Trade and Investment Policy Agendas; Comment on “How Neoliberalism Is Shaping the Supply of Unhealthy Commodities and What This Means for NCD Prevention”

Despite intergovernmental calls for greater policy coherence to tackle rising non-communicable diseases (NCDs), there has been a striking lack of coherence internationally and nationally between trade and health sectors. In this commentary, I explore the arguments by Lenucha and Thow in relation to barriers for greater coherence for NCDs, apply them to regional trade ag...

متن کامل

S Conceptual Cohesion of Classes in Object Oriented Systems

Cohesion measures in Object-oriented software reflect particular interpretations, High cohesion positively impacts understanding, reuse and maintenance. This paper proposes a new measure based on analysis of the unstructured information embedded in the source code, such as comments and identifiers, we have the existing applications based on using the only the structural information from the sou...

متن کامل

Advancing Public Health on the Changing Global Trade and Investment Agenda; Comment on “The Trans-Pacific Partnership: Is It Everything We Feared for Health?”

Concerns regarding the Trans-Pacific Partnership (TPP) have raised awareness about the negative public health impacts of trade and investment agreements. In the past decade, we have learned much about the implications of trade agreements for public health: reduced equity in access to health services; increased flows of unhealthy commodities; limits on access to medicines; and constrained policy...

متن کامل

Public Git Archive: a Big Code dataset for all

The number of open source software projects has been growing exponentially. The major online software repository host, GitHub, has accumulated tens of millions of publicly available Git versioncontrolled repositories. Although the research potential enabled by the available open source code is clearly substantial, no significant large-scale open source code datasets exist. In this paper, we pre...

متن کامل

A Systems Thinking Approach to Inform Coherent Policy Action for NCD Prevention; Comment on “How Neoliberalism Is Shaping the Supply of Unhealthy Commodities and What This Means for NCD Prevention”

Lencucha and Thow tackle the enormous public health challenge of developing non-communicable disease (NCD) policy coherence within a world structured and ruled by neoliberalism. Their work compliments scholarship on other causal mechanisms, including the commercial determinants of health, that have contributed to creating the risk commodity environment and barriers to N...

متن کامل

ذخیره در منابع من


  با ذخیره ی این منبع در منابع من، دسترسی به آن را برای استفاده های بعدی آسان تر کنید

برای دانلود متن کامل این مقاله و بیش از 32 میلیون مقاله دیگر ابتدا ثبت نام کنید

ثبت نام

اگر عضو سایت هستید لطفا وارد حساب کاربری خود شوید

عنوان ژورنال:

دوره   شماره 

صفحات  -

تاریخ انتشار 2016