Page 38 : 47
Elucidative Programming
* Introduction
Introduction
Kinds of understanding
Plan of the IWPC talk
Plan of the COT talk
Plan of the SIGDOC talk
* Overall Observations
Which kind of documentation
Views on documentation
Integrated program documentation
* Literate Programming
Literate Programming and the WEB System
An example of a literate program
Internal structure of a literate program (1)
Internal structure of a literate program (2)
The WEB tools for literate programming
Problems with WEB-like literate programming
* Elucidative Programming
The meaning of the word
Elucidative Programming
Requirements
An example of an elucidative program
An example of an elucidative program
Examples of elucidative programs
The elucidative programming model
The source format of the documentation - Scheme
The source format of the documentation - Java
Tool Overview
The elucidator tool
The editor tool
The browser tool
Tool Integration
Tool philosophy
The Scheme Elucidator
The Java Elucidator
The Design of the Java Elucidator
Minor features
NWPER'2000 Questions
A broader perspective on the use of an elucidator
* Experience
Educational experience
Industrial experience
Industrial quotes
* Status and Conclusions
Status and Conclusions
* Further Information
Web resources about EP
NWPER'2000 Questions
Here are my answers to the questions that where asked to all NWPER'2000 speakers.
What is the main novelty/contribution of the paper?
A WWW approach to internal program documentation
A variation of literate programming which 'leaves the program in peace'
How will this novelty/contribution improve SD practice or SD research?
It could perhaps demonstrate an attractive way to document program understanding
An educational effort will be needed to make a practical impact
What are the main problems with the novelty/contribution and/or with the paper?
The general reluctance to document any understanding related to the program as such
The problem of what to document when
Can the proposed approach be expected to scale to real-life problems?
Probably not in its current elaboration
We are working on variations which we hope will