Work

Comments are More Important than Code

Year: 2005
Type: article
Abstract: In this essay I take what might seem a paradoxical position. I endorse the techniques that some programmers claim make code self-documenting and encourage the development of programs that do “automatic documentation.” Yet I also contend that these methods cannot provide the documentation necessary for reliable and maintainable code. They are only a rough aid, and even then help with only one or two aspects of documentation—not including the most important ones.
Source: Queue
Author: Jef Raskin
Language: English
Open Access status: bronze
OpenAlex ID: W1996878879
FWCI: 3.822
Cites:
Cited by: 46
Related to: 10