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

FW: proposal for improving <documentation>

From: Gaertner, Dietmar <Dietmar.Gaertner@softwareag.com>
Date: Thu, 18 Sep 2003 17:06:23 +0200
Message-ID: <DFF2AC9E3583D511A21F0008C7E6210606B17DC5@daemsg02.software-ag.de>
To: "'www-ws-desc@w3.org'" <www-ws-desc@w3.org>
Why not using 

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

directly, ommitting the wsdl clone at all?

Regards, Dietmar.

-----Original Message-----
From: Sanjiva Weerawarana [mailto:sanjiva@watson.ibm.com] 
Sent: Thursday, September 18, 2003 1:45 PM
To: www-ws-desc@w3.org
Subject: proposal for improving <documentation>



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 11:06:30 GMT

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