Page 32 : 40

Elucidative Programming * Introduction Where is Denmark? Where is Aalborg? Plan of this talk Introduction Kinds of understanding 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 More examples of elucidative programs The elucidative programming model The source format of the documentation - Scheme Tool Overview The elucidator tool The editor tool The browser tool Tool Integration Tool philosophy Integration with LAML SchemeDoc A broader perspective on the use of an elucidator Program Evolution * Experience Industrial experience Industrial quotes * Status and Conclusions Status and Conclusions * Further Information Web resources about Elucidative Programming

A broader perspective on the use of an elucidator

Here we will list a number of potential areas which we expect can be supported by the elucidator.

Most documents that need to address program units or program details will be able to benefit from the ideas of elucidative programming

Documents with 'an elucidative potential': Diaries and logs Written code reviews and code walk throughs Program tutorials Design documents Maintenance documentation