This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 7136 - Eventing: Suggested edits/cleanup of wrapped/unwrapped defintions.
Summary: Eventing: Suggested edits/cleanup of wrapped/unwrapped defintions.
Status: CLOSED REMIND
Alias: None
Product: WS-Resource Access
Classification: Unclassified
Component: Eventing (show other bugs)
Version: FPWD
Hardware: PC Windows XP
: P2 normal
Target Milestone: ---
Assignee: notifications mailing list for WS Resource Access
QA Contact: notifications mailing list for WS Resource Access
URL:
Whiteboard:
Keywords: hasProposal
Depends on:
Blocks:
 
Reported: 2009-07-24 13:59 UTC by Martin Chapman
Modified: 2009-09-16 08:13 UTC (History)
2 users (show)

See Also:


Attachments

Description Martin Chapman 2009-07-24 13:59:08 UTC
I think the definition in (the new) 2.3 of wrapped and unwrapped is still a bit imprecise and self-referencing, but I think the fix is simple.
I would suggest adding the words "defined by this specification" at the end of the second sentence, giving:

"Use of wrapped format indicates that notification messages should be contained in a wrapper element defined by this specification."

Without such a qualification this would lead to ambiguity as one person's wrapper is another person's unwrapped!

And just being pedantic I would also suggest changing:

"Use of unwrapped format indicates that notification messages are not wrapped."

To

"Use of unwrapped format indicates that notification messages are not contained in a wrapper element."

I also think the second paragraph is confusing, as formatting is always engaged, it's just a question of what sort!

So how about changing:
"When the Delivery Format feature is engaged the formatting of the going events occurs after any filtering."

To:

"Filtering occurs prior to any formatting of notification messages." 

The sum total of these suggestions would give:

"2.3 Notification Formats

This specification specifies two delivery formats: wrapped and unwrapped. Use of wrapped format indicates that notification messages should be contained in a wrapper element defined by this specification. Use of unwrapped format indicates that notification messages are not contained in a wrapper element. 

Filtering occurs prior to any formatting of notification messages. This ensures that regardless of what type of formatting might occur, the same Filter dialect/expression can be used to subset the event stream."
Comment 1 Robert Freund 2009-08-04 17:53:45 UTC
Resolved as proposed