R. Escalona
ABSTRACT
It is well known that a programmer's main idea is to generate results, but these are often only partially done. Generally, they want to finish the program well to document it afterwards; however, they never do so. Sometimes they are assigned to a new project, and they expect to have an opportunity to document what they have written at a later date. Other times, programmers have their own ideas, like ownership or professional secrets, and so on and so forth, but the truth is, few programmers document their programs, and fewer document them well.
If there is a method that allows the programmer to document before writing a program or while he is writing it, such a program will, obviously, be documented in the most proper manner.
This paper will describe some experiences in using the method of J.D. Warnier to design programs, and, therefore, its graphs are used as documentation.
- 1.Warnier, J.D.- Logical Construction of Programs: Van Nostrand Reinhold Co. Google Scholar
Digital Library
- 2.Higgins, David- Designing Structured Programs; Prentice-Hall. Google ScholarDigital Library
Index Terms
- Case study of the methodology of J. D. Warnier to design structured programs as systems documentation
Recommendations
The myth and realities of C.A.S.E. for documentation
SIGDOC '89: Proceedings of the 7th annual international conference on Systems documentationHypertext seems to be the major focus of user documentation groups, and even some system documentation people. But system developers, engineers and architects are interested in C.A.S.E. More of our documentation work will be coming from or going into ...
Documentation: Effective AND literate
SIGDOC '85: Proceedings of the 4th annual international conference on Systems documentationThe purpose of this paper is to show how documentation can be literate, in a stylistic sense, and still be effective. Literate prose is a powerful tool that, when properly used in computer documentation, can take advantage of the full power of the ...
On the composition of well-structured programs
Classics in software engineeringWirth's "On the Composition of Welt-Structured Programs" is one of three papers selected from the December 1974 issue of ACM Computing Surveys. Together with Knuth's "Structured Programming with go to Statements" [Paper 20] and Kernighan and Plauger's "...
Comments