Re: WS-Eventing, WS-MetadataExchange, WS-Event-Description remarks

I think that we are constrained to reference the authoritative versions no matter what format.
The publishing group sometimes selects something other than HTML.
-bob

On Aug 4, 2010, at 10:43 PM, Doug Davis wrote:

> 
> Stephan - thanks for the thorough review.  See comments below 
> and look at the latest editor's copies to see the edits. 
> -Doug 
> 
> Stephan wrote on 08/04/2010 11:29:02 AM:
> 
> > Hello,
> > 
> > while reading the current version of different ws-ra specs (30 March 
> > 2010) I have got a few remarks:
> > 
> > 
> > WS-Eventing
> > 
> > - Reference: I think it is better to link to the HTML version of other 
> > specifications (such as WS-MakeConnection) than Word or PDF documents. 
> > Especially when reading the ws-eventing spec in an Internet browser.
> 
> Will do this for all specs - not finished yet though. 
> 
> > - Example 2-1: use urn:uuid:... instead of uuid:... for MessageID in 
> > line 11 and all following messageIDs and corresponding RelatesTo. A far 
> > as I know this is the typical version of MessageIDs. See 
> > http://tools.ietf.org/html/rfc4122 and
> > http://docs.oasis-open.org/ws-dd/issues/WSDDIssues.xml#i050
> 
> Fixed for all specs. 
> 
> > - Typo in 4.2: "message" occurs twice in "The Renew request message 
> > message MUST be of the following form:"
> 
> Fixed 
> 
> > - Table 5-2 (Subscription Manager Action Table): In the "Unsubscribe 
> > Request [msg]" it is not sufficient to "Send UnsubscribeResponse" only. 
> > The subscription should be invalidated before.
> 
> Fixed. 
> 
> > Section A.1 last sentence: GED is not introduced in this document. It is 
> > only known from the ws-event-description spec (section 4.1).
> 
> Fixed 
> 
> > 
> > WS-MetadataExchange:
> > 
> > - Section 8.2 first box: indentation of "<wsa:Metadata>" wrong
> 
> can't seem to find this one - can you elaborate a bit?  or perhaps its already been fixed? 
> 
> > - Example 8-6 line 04: typo in "RerenceParameters" and in line 08: "wmlns"
> 
> Can't find this one either - appears to be fixed already. 
> 
> > - Example 9-1 line 14-15: Would it be better to use from the 
> > ws-event-descriptions spec example 4-1 line 12-14 with the following 
> > attributes: name="WindReportEvent" element="ow:WindReport" 
> > actionURI="http://www.example.org/oceanwatch/2003/WindReport"? There is 
> > no context between WindReport and StockQoute. In case of modifications 
> > the following paragraphs have to be updated (<sq:Quote>, line number)
> 
> Fixed 
> 
> > - Section 9, second grey box (the one after example 9-1): misses a line 
> > 19 with the closing policy tag. Maybe name it example 9-2. For me it is 
> > not clear, why the first box is named example 9-1 and the following do 
> > not have "names" to reference.
> 
> Fixed 
> 
> > - Section 9, last grey box (third): in the closing notifyTo the "to" is 
> > missing
> 
> Fixed 
> 
> > - Example 12-2 line 05: a trailing slash in the start tag
> 
> Already fixed. 
> 
> > 
> > WS-Event-Description:
> > 
> > - example 4-3 line 03: typo "EventDescritions"
> 
> Fixed 
> 
> > 
> > Kind regards,
> > Stephan
> > 
> >