Re: issues 7586, 7588, 7828 - editorial request

I take it you mean "refer people back to [Subscribe|Enumerate]Response", 
but yeah, +1.

- gp

On 10/27/2009 4:44 PM, Doug Davis wrote:
>
> While adding the text for issues 7586, 7588 and 7828 I noticed that we 
> saved a lot of space in wsenum and wseventing by not repeating the 
> definition of the children elements when we define the Renew operation 
> - we just point people back to Susbcribe/Enumerate.  For example, 
> ws-enum Renew says:
>
> Components of the outline listed above are additionally constrained as 
> for a request to create an enumeration (see *_3.1 Enumerate_* 
> <file:///d:/wstk/wsra/cvs/edcopies/wsenum.html#Enumerate>) with the 
> following addition(s):
>
> However, for some reason on the Response side of the Renew operation 
> (for both specs) we do mention the GrantedExpires element:
>
> Components of the outline listed above are constrained as for a 
> response to an Enumerate request (see *_3.1 Enumerate_* 
> <file:///d:/wstk/wsra/cvs/edcopies/wsenum.html#Enumerate>) with the 
> following addition:
>
> *[Body]*/wsen:RenewResponse/wsen:GrantedExpires
> If the requested expiration is a duration, then the implied start of 
> that duration is the time when the data source starts processing the 
> Renew request.
>
> Notice that  1) we point people back to Enumerate, and 2) the text for 
> GrantedExpires doesn't really add anything beyond what Enumerate 
> already says for this element.
>
> If people are ok with it, I'd like to just remove this 
> extra/semi-duplicate definition of GrantedExpires from Renew for both 
> Eventing and Enum - in both cases people will be directed back to the 
> Enumerate/Subscribe operation so nothing should be lost and we avoid 
> possible inconsistencies in the specs.  Its worth noting that we do 
> this for GetStatus in both specs already.
>
> I'll wait a couple of days and if no one objects I'll make the update 
> as an editorial tweak.
>
> thanks
> -Doug
> ______________________________________________________
> STSM |  Standards Architect  |  IBM Software Group
> (919) 254-6905  |  IBM 444-6905  |  dug@us.ibm.com
> The more I'm around some people, the more I like my dog.
>

Received on Wednesday, 28 October 2009 00:26:03 UTC