The effect of modularization and comments on program comprehension

Authors:
S. N. Woodfield;H. E. Dunsmore;V. Y. Shen
Affiliations:
-;-;-
Venue:
ICSE '81 Proceedings of the 5th international conference on Software engineering
Year:
1981

Citing 4
Cited 16

Some ideas on data types in high-level languages

Communications of the ACM
On the criteria to be used in decomposing systems into modules

Communications of the ACM
Structured Design: Fundamentals of a Discipline of Computer Program and Systems Design

Structured Design: Fundamentals of a Discipline of Computer Program and Systems Design
Psychological complexity of computer programs: an experimental methodology

ACM SIGPLAN Notices

A paradigm for programming style research

ACM SIGPLAN Notices
An annotated bibliography on software maintenance

ACM SIGSOFT Software Engineering Notes
VHDL quality: synthesizability, complexity and efficiency evaluation

EURO-DAC '95/EURO-VHDL '95 Proceedings of the conference on European design automation
Principles of package design

Communications of the ACM
Software Measurement: A Necessary Scientific Basis

IEEE Transactions on Software Engineering
Theories and techniques of program understanding

CASCON '91 Proceedings of the 1991 conference of the Centre for Advanced Studies on Collaborative research
/*icomment: bugs or bad comments?*/

Proceedings of twenty-first ACM SIGOPS symposium on Operating systems principles
Hotcomments: how to make program comments more useful?

HOTOS'07 Proceedings of the 11th USENIX workshop on Hot topics in operating systems
TODO or to bug: exploring how task annotations play a role in the work practices of software developers

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
An empirical analysis of the impact of software development problem factors on software maintainability

Journal of Systems and Software
Listening to programmers Taxonomies and characteristics of comments in operating system code

ICSE '09 Proceedings of the 31st International Conference on Software Engineering
Assessing the understandability of UML statechart diagrams with composite states--A family of empirical studies

Empirical Software Engineering
A study of comment abstraction, coupling, and placement

SEA '07 Proceedings of the 11th IASTED International Conference on Software Engineering and Applications
Towards automatically generating summary comments for Java methods

Proceedings of the IEEE/ACM international conference on Automated software engineering
Controversy Corner: On the relationship between comment update practices and Software Bugs

Journal of Systems and Software

Quantified Score

Hi-index	0.02

Visualization

Abstract

An experiment was conducted to investigate how different types of modularization and comments are related to programmers' ability to understand programs. Forty-eight experienced programmers were given eight different versions of the same program and asked to answer a twenty question quiz used to measure comprehension. These eight different versions were the result of the program being constructed with four types of modularization (monolithic, functional, super, and abstract data type), each with and without comments. Those subjects whose programs contained comments were able to answer more questions than those without comments. Also, those subjects who were given the abstract data type version of the program were able to do significantly better than those with any other type of modularization.