Abstract
The ability to comprehend a program written by other individuals is becoming increasingly important in software development and maintenance. In an attempt to encourage undergraduate Computer Science students to write informative and usable documentation, the literate programming paradigm was incorporated into the teaching of one undergraduate Computer Science course at Augustana College. This paper describes the concept of literate programming, the experience of using literate programming to teach good programming practices, and the results from the experiment that showed that literate programming encourages more documentation.
- 1 Avenarius, A. and Oppermann, S., "F'WEB" A Literate Programming System For FORTRAN8x", ACM SIGPLAN Notices, Vol.25, No.l, pp. 52-58, Jan 1990. Google Scholar
Digital Library
- 2 Brown, M., and Cordes, D., "A Literate Programming Design Language", Prec. CompEuro 90, IEEE International Conf. Computer Systems and Software Engineering, IEEE CS Press, Los Alamitos, Calif., 1990, pp. 548-549.Google Scholar
- 3 Chapin, N., "Software Maintenance: A Different View", AFIPS Conference Proceeding, 54th National Computer Conference, 1985, pp. 509-513.Google Scholar
- 4 Fletton N., and Munro, M. "Re.documenting Software Systems Using Hyportext Technology", IEEE Conference on Software Maintenance, 1988, pp. 54-59.Google Scholar
- 5 Gurari, E. and Wu, J., "A WYSIWYG Literate Programming System {Preliminary Report}",Procee~ings CSC '91, 1991, pp. 94-104. Google Scholar
Digital Library
- 6 Hyman, M., "Literate C + +", Computer Language, Jul 1990, Vol. 7, No.7, pp. 67-79.Google Scholar
- 7 Knuth, D. E., "Literate Programming", The Computer Journal, Vol. 27, No. 2, 1984, pp. 97-111. Google Scholar
Digital Library
- 8 Mmxin, J. and McClure, C., Software Maintenance: The Problem and Its Solutions. Prentice-Hall, 1983. Google Scholar
Digital Library
- 9 Y. Nakamoto, Y., Iwamoto, T., Hori, M., Ha#ham, K., Tokura, N., "An Editor for Documentation in C-system to Support So f~varc Development and Maintenance", IEEE 6th International Conference on Software Engineering, 1982, pp. 330-339. Google Scholar
Digital Library
- 10 Reenskaug, T., Skaar A., "An Environment For Literate Smalltalk Programming", OOPSLA 1989 Proceedings, pp. 337-345. Google Scholar
Digital Library
- 11 Shum, S., Cook, C., "AOPS: An Abstraodon Oriented Programming System For Literate Programming", Software Engineering Journal, Vol. 8 No. 3 (May 1993), pp. 113-120.Google Scholar
Cross Ref
- 12 Standish, T., "An Essay on Software Reuse", IEEE Trans on Software Engineering, Vol.SE-10, No.5, pp. 494-497, Sep 1984.Google Scholar
Digital Library
- 13 Thimble, by, H., "Experience of 'Literate Programming' Using CWEB {a Variant of Knuth's WEB}", The Computer Journal, Vol. 29, No. 3, 1986, pp. 201-211.Google Scholar
Cross Ref
- 14 Tung, S. H., "A Structured Method For Literate Programming", Structured Programming, 1989, Vol. 10, No. 2, pp. 113-120.Google Scholar
- 15 Wu,Y. and Baker,T., "A Source Code Documentation System For Aria", ACM Aria Letters, Vol.9, No.5, pp. 84-88, Jul/Aug 1989. Google Scholar
Digital Library
- 16 Zvegintzov, N., "Nanotrends", Datamation, Aug 1983, pp. 106-116.Google Scholar
Index Terms
Using literate programming to teach good programming practices
Recommendations
Using literate programming to teach good programming practices
SIGCSE '94: Proceedings of the twenty-fifth SIGCSE symposium on Computer science educationThe ability to comprehend a program written by other individuals is becoming increasingly important in software development and maintenance. In an attempt to encourage undergraduate Computer Science students to write informative and usable documentation,...






Comments