Views on computer program documentation and automation

Abstract

Various aspects of the problem of program documentation and description are discussed. Particular emphasis is placed on the problem of semantics. It is pointed out that the information produced by documentation of a program, if presented to several different groups, may mean entirely different things to these groups. Recognition of the fact that people look at problems differently is proposed as a more practical approach to the problem of documentation rather than extensive use of standards or strict formatting. The difficulties involved in searching for ways to provide a common ground for the transmission and use of information are discussed.