Map
Index
Random
Help
th

QuoteRef: parnDL12_1994

topics > all references > ThesaHelp: references p-r



ThesaHelp:
references p-r
Topic:
software documentation
Group:
software maintenance
Group:
program proving
Topic:
software review
Topic:
design documentation
Topic:
programming with a database of modules
Topic:
hypertext nodes made of names
Topic:
compiling pseudocode designs
Topic:
information retrieval by location
Group:
naming
Topic:
hierarchical naming
Topic:
proper names
Topic:
access to objects by a path
ThesaHelp:
topics a-e
Topic:
special relativity
Topic:
object-defined names
Topic:
access by current position
Topic:
names defined by context
Topic:
local vs. global
Topic:
formal methods and languages
Topic:
decision table
Topic:
requirement specification by assertion

Reference

Parnas, D.L., Madey, J., Iglewski, M., "Precise documentation of well-structured programs", IEEE Transactions on Software Engineering, 20, 12, December 1994, pp. 948-976. Google

Quotations
abstract ;;Quote: document a program with a set of independent displays, a lexicon, and an index; each display gives specification, program, and specifications of invoked programs
948 ;;Quote: since a successful program will be read more often than written, review and maintenance are at least as important as design
948 ;;Quote: a program is correct if it is correct when each part is correct, and if each part is correct
949 ;;Quote: documentators usually focus on the details that look difficult; but readers find that the basic structure is not obvious and the details are overwhelming
949 ;;Quote: the decomposition phase of the review process should be communicated by the designer; the reviewer should not need to derive the decomposition
950 ;;Quote: a well-structured program can always be written as a short text that names other programs that are themselves short
950+;;Quote: with displays, a program made of many short programs can be checked one display at a time
953 ;;Quote: a display is a 1-2 page document with a specification, a program, and all referenced specifications
953 ;;Quote: automatically construct a program from displays by calling procedures and expanding macros
953 ;;Quote: use a lexicon to define terms, functions, constants, and types that are used in multiple displays
953 ;;Quote: use tables to specify the post-value of a variable for various combinations of pre-values
953+;;Quote: an 'NC' entry specifies that the variable is not changed for that combination of pre-values
958 ;;Quote: used displays to inspect safety-critical software for a nuclear plant
958+;;Quote: the tabular organization of displays allowed a step-by-step review process
961 ;;Quote: checked that the displays satisfied the requirements document by transforming the display's tables into the corresponding requirement tables
966 ;;Quote: since programs can only be understood in small chunks, they should always be presented in complete, small pieces


Related Topics up

ThesaHelp: references p-r (245 items)
Topic: software documentation (64 items)
Group: software maintenance   (14 topics, 355 quotes)
Group: program proving   (10 topics, 310 quotes)
Topic: software review (80 items)
Topic: design documentation (43 items)
Topic: programming with a database of modules (94 items)
Topic: hypertext nodes made of names (13 items)
Topic: compiling pseudocode designs (8 items)
Topic: information retrieval by location (21 items)
Group: naming   (32 topics, 784 quotes)
Topic: hierarchical naming (28 items)
Topic: proper names (35 items)
Topic: access to objects by a path (13 items)
ThesaHelp: topics a-e (348 items)
Topic: special relativity (73 items)
Topic: object-defined names (15 items)
Topic: access by current position (7 items)
Topic: names defined by context (36 items)
Topic: local vs. global (29 items)
Topic: formal methods and languages (53 items)
Topic: decision table (29 items)
Topic: requirement specification by assertion (28 items)

Collected barberCB 5/97
Copyright © 2002-2008 by C. Bradford Barber. All rights reserved.
Thesa is a trademark of C. Bradford Barber.