Slide 26 : 47
The source format of the documentation - Scheme
A simple, specialized markup is used for the overall structure, the relations, and the source markers
HTML is used for additional markup purposes
Observations about the source format of the documentation
Non-obstructive, discrete, and terse
at least compared with XML-like markup
It is relatively easy and attractive to read the documentation in the editor
The supplementary use of HTML is in line with the choice in JavaDoc
Avoids proliferation of languages with similar purposes
The mixing of markup styles is not aesthetically pleasant
An excerpt of the time conversion documentation source
The Time Conversion example