W3C home > Mailing lists > Public > www-ws-desc@w3.org > September 2003

proposal for improving <documentation>

From: Sanjiva Weerawarana <sanjiva@watson.ibm.com>
Date: Thu, 18 Sep 2003 17:44:35 +0600
Message-ID: <00a501c37dda$3bcb0810$de120209@lankabook2>
To: <www-ws-desc@w3.org>

I'd like to propose that we change <documentation> to be
consistent with XSD's <annotation> element:

<xsd:annotation>
  <xsd:documentation> human readable stuff </xsd:documentation>
  <xsd:appInfo> machine readable stuff </xsd:appInfo>
</xsd:annotation>

So, I propose we drop <wsdl:documentation> and replace it
with:

    <wsdl:annotation>
      <wsdl:documentation> human readable stuff </wsdl:documentation>
      <wsdl:appInfo> machine readable stuff </wsdl:appInfo>
    </wsdl:annotation>

This allows tools to use this hook and furthermore we'd
be consistent with XSD, which is said to be a good thing ;-).

Sanjiva.
Received on Thursday, 18 September 2003 07:45:11 GMT

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