Re: [wsbpel] Issue - R9 - Remove LED Comment on eventHandlersdeclaration

[Danny van der Rijn <dannyv@tibco.com>]

In today's call, Alex voiced an opinion that the comments should stay.  My objection is less that they exist, and more that for someone who is reading the XSD for any reason other than editing the XSD or other similar reason, the comments come out of left field.  What percentage of the readers will even know what an "LED" is?

So a proposal for this can take 2 routes:

1) Remove the comments

2) Change the comments somewhat.  Along the lines of:

<xsd:documentation>
       XSD Authors:  The child element onAlarm needs to be a Local Element Declaration, because there is another
       onAlarm element defined for the pick activity.
</xsd:documentation> 

On the call today I said that I would solicit opinions before making a proposal.  Opinions for alternate 2) will not be taken as endorsement of the above text, merely as a desire to keep the comments but reword them.

Danny van der Rijn wrote:

This is true in more places than just the one cited.

ws-bpel issues list editor wrote:

This issue has been added to the wsbpel issue list with a status of "received". The status will be changed to "open" if a motion to open the issue is proposed and that motion is approved by the TC. A motion could also be proposed to close it without further consideration. Otherwise it will remain as "received".

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 - R9 - Remove LED Comment on eventHandlers declaration

Status: received
Date added: 19 Sep 2006
Date submitted: 15 September 2006
Submitter: Danny van der Rijn
Description: The following is in the XSD declaration of eventHandlers

<xsd:documentation>
       Child element onAlarm needs to be a LED, because there is another
       onAlarm element defined for the pick activity.
</xsd:documentation> 
  

This is only interesting to XSD authors, and so probably not for the general audience.
Submitter's proposal: Remove the comment
Changes: 19 Sep 2006 - new issue

---

To comment on this issue (including whether it should be accepted), 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 - R9 - [anything]" or is a reply to such a message. If you want to formally propose a resolution to an open issue, please start the subject line "Issue - R9 - Proposed resolution", without any Re: or similar.

To add a new issue, see the issues procedures document