Issue - 149 - adding formal <documentation> support to BPEL

[ws-bpel issues list editor<peter.furniss@choreology.com>]

This issue has been added to the wsbpel issue list. The issues list is posted as a Technical Committee document to the OASIS WSBPEL TC pages on a regular basis. The current edition, as a TC document, is the most recent version of the document entitled in the "Issues" folder of the WSBPEL TC document list - the next posting as a TC document will include this issue. The list editor's working copy, which will normally include an issue when it is announced, is available at this constant URL.

Issue - 149 - adding formal <documentation> support to BPEL

Status: open
Categories: Syntax and validation
Date added: 20 Jul 2004
Submitter: Alex Yiu
Date submitted: 20 July 2004
Description: It would be a good idea to add a formal <documentation> element to all BPEL 
extensible elements. The element pattern will be based on XSD/annotation/documentation 
(which is slightly different from WSDL/documentation pattern). Hopefully, this 
suggestion is not controversial. 
Submitter's proposal: Here is the suggested schema changes:

    <import namespace="http://www.w3.org/XML/1998/namespace" 
        schemaLocation="http://www.w3.org/2001/xml.xsd" />
     <element name="documentation" id="documentation">
        <complexType mixed="true">
            <sequence minOccurs="0" maxOccurs="unbounded">
                   <any processContents="lax"/>
            </sequence>
            <attribute name="source" type="anyURI"/>
            <attribute ref="xml:lang"/>
        </complexType>
    </element>
    <complexType name="tExtensibleElements">
        <annotation>
            <documentation>
        This type is extended by other component types
        to allow elements and attributes from
        other namespaces to be added.
       </documentation>
        </annotation>
        <sequence>
            <element ref="bpws:documentation" minOccurs="0" maxOccus="unbounded" />
            <any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
        </sequence>
        <anyAttribute namespace="##other" processContents="lax"/>
    </complexType>

Changes: 20 Jul 2004 - new issue

---

To comment on this issue, please follow-up to this announcement on the wsbpel@lists.oasis-open.org list (replying to this message should automatically send your message to that list), or ensure the subject line as you send it starts "Issue - 149 - [anything]" or is a reply to such a message. If you want to formally propose a resolution, please start the subject line "Issue - 149 - Proposed resolution", without any Re: or similar.

To add a new issue, see the issues procedures document (but the address for new issue submission is the sender of this announcement).