W3C home > Mailing lists > Public > www-ws-desc@w3.org > February 2007

Assertion Summary Texts in Part 1

From: Ramkumar Menon <ramkumar.menon@gmail.com>
Date: Mon, 5 Feb 2007 15:50:10 -0800
Message-ID: <22bb8a4e0702051550r7c444288w7535480e6fe508a3@mail.gmail.com>
To: www-ws-desc@w3.org
Hi Gurus,

One suggestion.Part 1 - Appendix E [Assertion Summary] is a great view of
all assertions about component models and documents.
I would appreciate if the Summary text be a complete English sentence that
contains the complete text about the assertion.

For instance, see the following assertion.

-----------------------------------------------
Assertion Id                 Summary
-----------------------------------------------
Description-1201005     Zero or more element information items amongst its
[children], in order as follows:

If the User were reading this in soft copy, he/she could click on the
Assertion Id hyperlink to navigate to the section that states the assertion.
But if the User were reading the specification on a hard print, it would not
be possible for he/she to get a clear understanding on what it means.  Note
that there are other assertions in this section which depict similar
behaviour.

Hope that helps.
rgds,
Ram



-- 
Shift to the left, shift to the right!
Pop up, push down, byte, byte, byte!

-Ramkumar Menon
A typical Macroprocessor
Received on Monday, 5 February 2007 23:50:24 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:58:46 GMT