Page 41 : 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

Educational experience

The Java Elucidator has been tried out by a group of Dat1 students in the fall of 2000

We have examined the usefulness of Elucidative Programming in seven different areas: Review situations Confidence of knowledge about software Further confidence through inclusion of tests Maintenance of Elucidative Programs is manageable during development Programs become less error prone Ease of maintenance Generally, the tool is useful