W3C home > Mailing lists > Public > www-ws-desc@w3.org > January 2004

Re: WSDL Specification readability: formulaic text

From: Amelia A Lewis <alewis@tibco.com>
Date: Tue, 27 Jan 2004 14:35:08 -0500
To: David Orchard <dorchard@bea.com>
Cc: www-ws-desc@w3.org
Message-id: <EA510674-50FF-11D8-81D8-0050E416A465@tibco.com>


On Jan 27, 2004, at 2:43 AM, David Orchard wrote:

>
> The WSDL specs contains a lot of formulaic text, making them harder to 
> read
> than they could be. A lot of the infoset related data could be easily 
> moved

Actually, it can't.  The spec is formally defined in terms of the 
infoset.  So it's normative, and belongs in the normative part.

It would be nice if specifications were generally very readable, but it 
isn't particularly important.  It *is* important to almost all 
specification writers that the result be precise and completely 
unambiguous.

We have a tutorial for narrative and discursive introduction and 
explanation.  That seems a likelier place to expend energies on making 
it maximally accessible.

All my opinion, of course.

Amy!
Received on Tuesday, 27 January 2004 14:34:21 GMT

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