Group:
hypertext
Topic:
comments
Topic:
compiling pseudocode designs
Topic:
localized understanding
Topic:
program listing
Topic:
program web
Topic:
programming style
Topic:
pseudocode design
Topic:
software documentation
Topic:
stepwise refinement
Topic:
Thesa as a database of modules
Topic:
understanding systems
Topic:
using a computer as a communication/information medium
| |
Summary
Literate programming is the idea that a program should communicate an idea. So two parts, one for the user and the other for the computer. (cbb 4/89)
Subtopic: programmer as essayist 
| Quote: the readability of programs is immeasurably more important than their writeability; self-documenting code; pleasant style [»hoarCA_1974]
| | Quote: literate programs written for understanding by humans; programmer as essayist; concepts presented in best order either formally or informally [»knutDE2_1984]
| | Quote: Knuth found literate programming a much better way of programming [»knutDE2_1984]
| | Quote: complex software consists of simple parts and relations; the programmer's goal is human comprehension [»knutDE2_1984]
|
Subtopic: rich text
| Quote: describing software requires more than a word processor; e.g., software literature uses graphics, tables, fonts [»joneTC4_1979a]
| | Quote: KMS agents are frames with documentation, graphics, images, and cross-references to other frames [»akscRM11_1993]
|
Subtopic: source-rich
| Quote: a source-full environment, like Lisp, includes access to all functions; yet usually no access to operating system, compiler, or applications [»weisM11_1987]
| | Quote: every definition in Common Lisp includes on-line documentation strings; allows user to query a symbol without searching text [»tichWF11_1987]
|
Subtopic: web of ideas
| Quote: express a program as a web of ideas with structural relationships with neighbors [»knutDE2_1984]
| | Quote: in WEB, refer to parts of the program by an informal top-level description [»knutDE2_1984]
| | Quote: in WEB a section's comments motivates and explains its program text [»knutDE2_1984]
| | Quote: in WEB each part of program has its appropriate size [»knutDE2_1984]
|
Subtopic: generating program from web
| Quote: the TOPD flattener removes all hierarchical structure; then it's translated into equivalent COBOL statements [»hendP9_1975]
| | Quote: weaving a WEB program into a document; tangling it into a program [»knutDE2_1984]
| | Quote: installation procedure for WEB [»knutDE2_1984]
|
Subtopic: problems with literate programming
Quote: literate programming is currently ill-suited for software developers; limited to implementation phase, high overhead, awkward
[»cordD6_1991]
|
Related Topics
Group: hypertext (44 topics, 786 quotes)
Topic: comments (23 items)
Topic: compiling pseudocode designs (8 items)
Topic: localized understanding (43 items)
Topic: program listing (14 items)
Topic: program web (8 items)
Topic: programming style (47 items)
Topic: pseudocode design (43 items)
Topic: software documentation (64 items)
Topic: stepwise refinement (25 items)
Topic: Thesa as a database of modules (23 items)
Topic: understanding systems (48 items)
Topic: using a computer as a communication/information medium
(32 items)
|
