The Computer Journal
The practice of programming
On the criteria to be used in decomposing systems into modules
Communications of the ACM
Coping with Crosscutting Software Changes Using Information Transparency
REFLECTION '01 Proceedings of the Third International Conference on Metalevel Architectures and Separation of Crosscutting Concerns
Fine grained indexing of software repositories to support impact analysis
Proceedings of the 2006 international workshop on Mining software repositories
Using evolutionary annotations from change logs to enhance program comprehension
Proceedings of the 2006 international workshop on Mining software repositories
Shared waypoints and social tagging to support collaboration in software development
CSCW '06 Proceedings of the 2006 20th anniversary conference on Computer supported cooperative work
/*icomment: bugs or bad comments?*/
Proceedings of twenty-first ACM SIGOPS symposium on Operating systems principles
Journal of Software Maintenance and Evolution: Research and Practice
Hotcomments: how to make program comments more useful?
HOTOS'07 Proceedings of the 11th USENIX workshop on Hot topics in operating systems
Proceedings of the 30th international conference on Software engineering
SNIFF: A Search Engine for Java Using Free-Form Queries
FASE '09 Proceedings of the 12th International Conference on Fundamental Approaches to Software Engineering: Held as Part of the Joint European Conferences on Theory and Practice of Software, ETAPS 2009
Listening to programmers Taxonomies and characteristics of comments in operating system code
ICSE '09 Proceedings of the 31st International Conference on Software Engineering
Conversations in developer communities: a preliminary analysis of the yahoo! pipes community
Proceedings of the fourth international conference on Communities and technologies
Analyzing the co-evolution of comments and source code
Software Quality Control
An exploratory study of the evolution of software licensing
Proceedings of the 32nd ACM/IEEE International Conference on Software Engineering - Volume 1
An eclectic approach for change impact analysis
Proceedings of the 32nd ACM/IEEE International Conference on Software Engineering - Volume 2
Mining development repositories to study the impact of collaboration on software systems
Proceedings of the 19th ACM SIGSOFT symposium and the 13th European conference on Foundations of software engineering
Toward a version control system for aspect oriented software
MEDI'11 Proceedings of the First international conference on Model and data engineering
Controversy Corner: On the relationship between comment update practices and Software Bugs
Journal of Systems and Software
What should developers be aware of? An empirical study on the directives of API documentation
Empirical Software Engineering
| Hi-index | 0.00 |
A programmer performing a change task to a system can benefit from accurate comments on the source code. As part of good programming practice described by Kernighan and Pike in the book The Practice of Programming, comments should "aid the understanding of a program by briefly pointing out salient details or by providing a larger-scale view of the proceedings." In this paper, we explore the widely varying uses of comments in source code. We find that programmers not only use comments for describing the actual source code, but also use comments for many other purposes, such as "talking" to colleagues through the source code using a comment "Joan, please fix this method." This kind of comments can complicate the mining of project information because such team communication is often perceived to reside in separate archives, such as emails or newsgroup postings, rather than in the source code. Nevertheless, these and other types of comments can be very useful inputs for mining project information.