proposal for improving <documentation>

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

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 UTC