We agreed readers should be able to see a short version of the spec that
hide the Z notation. I have prototyped an approach that I would like your
comments on. The idea is to have two documents: the normal, full length,
normative version that contains Z notation [1], and a short version that
hides the Z notation [2]. Each section of the spec that contains Z
notation is placed within a <z:notation> element and has an associate
anchor and link. Have a look at this pair of document and click on the
Hide and Show links. Note that these documents are best viewed in Internet
Explorer since they do not use Unicode characters yet.
The same approach could be used to Hide and Show other complex parts of
the spec, such as the infoset mapping.
The same effect can be achieved in a single document through the use of
Javascript, however when we discussed that a long time ago it got shot
down by the W3C team. It does have the advantage of requiring just one
document.
[1]
http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20-z-1.html#DefinitionsComponent
[2]
http://dev.w3.org/cvsweb/~checkout~/2002/ws/desc/wsdl20/wsdl20-z-1-short.html#DefinitionsComponent
Arthur Ryman,
Rational Desktop Tools Development
phone: +1-905-413-3077, TL 969-3077
assistant: +1-905-413-2411, TL 969-2411
fax: +1-905-413-4920, TL 969-4920
mobile: +1-416-939-5063
intranet: http://labweb.torolab.ibm.com/DRY6/