W3C home > Mailing lists > Public > www-ws-desc@w3.org > May 2005

RE: LC74c proposed resolution

From: Tom Jordahl <tomj@macromedia.com>
Date: Fri, 20 May 2005 11:35:48 -0400
Message-ID: <39A72E1EBF03EB44AACFD8036D1489F98A40A1@p02exm01.macromedia.com>
To: <www-ws-desc@w3.org>


+1

I like this proposal.

--
Tom Jordahl
Macromedia Server Development

> -----Original Message-----
> From: www-ws-desc-request@w3.org [mailto:www-ws-desc-request@w3.org]
On
> Behalf Of Amelia A Lewis
> Sent: Thursday, May 19, 2005 1:41 PM
> To: www-ws-desc@w3.org
> Subject: LC74c proposed resolution
> 
> 
> Heylas,
> 
> LC74c [1] raises issues related to internationalization of
> documentation elements, and proposes a solution.  Excerpted:
> 
> a) The <documentation> element require an xml:lang attribute.
>    The attribute may be empty (xml:lang="")
> b) The <documentation> element be allowed to be repeated,
>    provided the xml:lang attributes in each of the elements be unique.
> 
> I think that this is more than is necessary, on examination.
> 
> I recommend that we do only the following:
> 
> c) add maxOccurs="unbounded" to the reference to wsdl:documentation in
> the definition of DocumentedType.
> 
> We make no statements about how multiple documentations may relate to
> one another, if present, although the use case presented above is
> feasible and even likely.  We neither require xml:lang, nor require it
> to be unique (multiple documentation elements could, in theory, share
> the same xml:lang attribute value).
> 
> *Optionally*, we could make xml:lang a required attribute.  However,
> I'm not convinced that this is useful.  In my experience, much
> documentation seems to be written in Klingon, or possibly in the
> private languages of twins.  Permitting the recurrence of the
> documentation element permits proper internationalization (and
> potentially other use cases involving multiple documentation elements,
> such as an ASCII presentation versus an algorithm in MathML, perhaps,
> or different authorities for different documentation blocks); if it
> allows xml:lang, we're done.
> 
> Unfortunately, we do not allow attribute extension on a document
> element.  *sigh*  So, we should *also* add anyAttribute
> (namespace="##other") to the DocumentationType definition.
> 
> In short: change the recurrence of wsdl:documented in DocumentedType
to
> *, add attribute extensibility DocumentationType, let usage of
multiple
> documentation elements be determined in practice.
> 
> [1: http://www.w3.org/2002/ws/desc/4/lc-issues/#LC74c]
> 
> Amy!
> --
> Amelia A. Lewis
> Senior Architect
> TIBCO/Extensibility, Inc.
> alewis@tibco.com
Received on Friday, 20 May 2005 15:40:22 GMT

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