Some suggestions about documentation.

Originally the Synopses were implementation oriented sumaries of the previous description base Apocalypses. That meant that the Synopses were derivative and secondary to the Apocalypses

However, the Synopses are now primary specification and the Apocalypses have only historical significance. Also there are more Synopses than Apocalypses.

I suggest the introductory paragraphs to the Synopses are changed to reflect this.

It might also be useful to have a Synopsis 0 or Synopsis - index that documents the historical progression and indexes the Synopses.

For completeness of language specification, Synopsis 0 could list the other documents that form a part of the language definition, such as the test suite.


Reply via email to