This Article 
 Bibliographic References 
 Add to: 
Program Readability: Procedures Versus Comments
September 1988 (vol. 14 no. 9)
pp. 1271-1279

A 3*2 factorial experiment was performed to compare the effects of procedure format (none, internal, or external) with those of comments (absent or present) on the readability of a PL/1 program. The readability of six editions of the program, each having a different combination of these factors, was inferred from the accuracy with which students could answer questions about the program after reading it. Both extremes in readability occurred in the program editions having no procedures: without comments the procedureless program was the least readable and with comments it was the most readable.

[1] O. J. Dahl, E. W. Dijkstra, and C. A. R. Hoare,Structured Programming. London: Academic, 1972.
[2] J. L. Elshoff, and M. Marcotty, "Improving computer program readability to aid modification,"Commun. ACM, vol. 26, no. 8, pp. 512- 521, Aug. 1982.
[3] J. D. Gannon and J. J. Horning, "Language design for programming reliability,"IEEE Trans. Software Eng., vol. SE-1, no. 2, pp. 179- 191, June 1975.
[4] B. W. Kernighan and P. J. Pauger,The Elements of Programming Style. New York: McGraw-Hill, 1974.
[5] H. F. Ledgard,Programming Proverbs. Rochelle Park, NJ: Hayden, 1975.
[6] A. F. Norcio, "Indentation documentation and programmer comprehension," inProc. Human Factors in Computer Systems, ACM, Washington, DC, 1981, pp. 118-120.
[7] B. Shneiderman,Software Psychology: Human Factors in Computer and Information Systems. Boston, MA: Little, Brown, 1980.
[8] B. Shneiderman, "Control flow and data structure documentation: Two experiments,"Commun. ACM, vol. 25, no. 1, pp. 55-63, Jan. 1982.
[9] T. C. Tenny, "Procedures and comments vs. the Banker's Algorithm,"SIGCSE Bull., vol. 17, no. 3, pp. 44-53, Sept. 1985.
[10] L. M. Weissman, "A methodology for studying the psychological complexity of computer programs," Ph.D. dissertation, Univ. Toronto, Tech. Rep. CSRG-37, Aug. 1974.
[11] L. M. Weissman, "Psychological complexity of computer programs: An experimental methodology,"SIGPLAN Notices, vol. 15, no. 6, pp. 25-36, June 1974.
[12] B. J. Winer,Statistical Principles in Experimental Design, 2nd. ed. New York: McGraw-Hill, 1971.
[13] E. Yourdon and L. L. Constantine,Structured Design. Englewood Cliffs, NJ: Prentice-Hall, 1979.

Index Terms:
procedures; comments; factorial experiment; procedure format; PL/1 program; readability; PL/1; programming
T. Tenny, "Program Readability: Procedures Versus Comments," IEEE Transactions on Software Engineering, vol. 14, no. 9, pp. 1271-1279, Sept. 1988, doi:10.1109/32.6171
Usage of this product signifies your acceptance of the Terms of Use.