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

RE: Assertion Summary Texts in Part 1

From: Jonathan Marsh <jonathan@wso2.com>
Date: Thu, 15 Feb 2007 16:49:17 -0800
To: "'Ramkumar Menon'" <ramkumar.menon@gmail.com>
Cc: <public-ws-desc-comments@w3.org>
Message-ID: <036801c75164$4b48f340$3501a8c0@DELLICIOUS>
Thank you for the comment.  The Working Group this issue as a CR150 [1].

 

While we agreed that this summary could be improved, the WG felt it served
its primary purpose in providing a bit of text describing the assertion and
a link back to the assertion in context.  Since we're days away from
completing the spec a comprehensive review and proposals for improving each
assertion would be time-consuming, and we didn't have members willing to
volunteer to do this work.  We therefore closed this issue with no action.

 

Unless you let us know otherwise within 2 weeks, we will assume you agree
with the resolution of this issue.

 

[1] http://www.w3.org/2002/ws/desc/5/cr-issues/issues.html#CR150 

 

 

Jonathan Marsh -  <http://www.wso2.com> http://www.wso2.com -
<http://auburnmarshes.spaces.live.com> http://auburnmarshes.spaces.live.com

 

  _____  

From: www-ws-desc-request@w3.org [mailto:www-ws-desc-request@w3.org] On
Behalf Of Ramkumar Menon
Sent: Monday, February 05, 2007 3:50 PM
To: www-ws-desc@w3.org
Subject: Assertion Summary Texts in Part 1

 

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 Friday, 16 February 2007 00:49:22 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:20:33 GMT