Slide 17 : 38
The source format of the documentation
Scheme:
A simple, specialized markup is used for the overall structure, the relations, and the source markers
Non-obstructive, discrete, and terse
It is relatively easy and attractive to read the documentation in the editor
Java:
An XML markup language is used for the overall structure, the relations, and the source markers
Standard, and general markup language
Can be processed via a number of different tools
HTML is used for additional markup purposes
Avoids proliferation of languages with similar purposes
The mixing of markup styles is not aesthetically pleasant
An excerpt of the time conversion documentation source - Scheme
An excerpt of the time conversion documentation source - Java