Lecture overview -- Keyboard shortcut: 'u'  Previous page: Views on documentation -- Keyboard shortcut: 'p'  Next page: Literate Programming [Section] -- Keyboard shortcut: 'n'  Lecture notes - all slides and notes together  slide -- Keyboard shortcut: 't'  Help page about these notes  Alphabetic index  Course home  Page 9 : 40
Elucidative Programming
Integrated program documentation

We will here explore the possibilities of integrating programs and written program documentation

There are several ways to integrate the source program and the documentation

  • The documentation is embedded in the program

    • Conventional program comments

    • The program is the main structure

  • The program is embedded in the documentation

    • Literate Programming

    • The documentation is the main structure

  • The program and the documentation are separated, but connected via links

    • Hypertext approach

    • The starting point of Elucidative Programming