Re: [wsrf] Some Thoughts on WSRF61: WS-RF Primer/App Note/Usage Notes

[Tim Banks <tim_banks@uk.ibm.com>]

Alan, (& Ian)

+1

These are good suggestions. I also think supporting documentation is
important to encouraging uptake of the specifications, and worked on the
Primer for the OGSI specification so, to a first approximation, upgrading
that book would be one way to start a document for supporting WSRF.
Attached are the index pages of the OGSI Primer for you to get a flavour of
it.

(See attached file: OGSI Primer Index Pages.pdf)


You can see the whole document by googling for
'draft-ggf-ogsi-gridserviceprimer-5'


I think the difference between this and what you are suggesting as an
'appnote' is that it spends more time on introduction: 'Primer' suggests
the first port of call for people who want to know about WSRF, but not the
last word in normative definition. We already have the whitepapers on
Stateful Web Services which act as some kind of introduction, so I would
imagine folding some of that material into a Primer, but also including
simple, illustrative examples.  You'll see that this takes around  60
pages.

What you are proposing below seems to me to be illustrative of more
realistic usage of the WSRF specs and how it combines with other specs, so
it might build on the concept of a 'Primer'.


Regards, Tim Banks
IBM TP Architecture & Technology. Hursley, UK.
Phone: External +44 1962 815639, Internal 245639

Ian Robinson/UK/IBM@IBMGB wrote on 21/08/2004 12:54:48:

>
>
>
>
> Alan, I think you have a pretty good initial set of items for
> consideration. My comments:
>
>
> Rather than "Definitions of various terms: WS Resource, Implied Resource
> Pattern, Factory Pattern, etc (we can extract information from the two
> whitepapers (The WS-Resource Framework and Modelling Stateful Resources
> with Web Services)" we should use the material from the new normative
spec
> (that we kicked off at the last F2F). These definitions need to be part
of
> the normative specs.
>
>
> For use cases, the WS-RP use-cases that Rich talked about are also
valuable
> (ie modelling portlets as WS-Resources)>
>
>
>
>
> Regards,
> Ian Robinson
> ian_robinson@uk.ibm.com
>
>
>

>              "Alan

>              Weissberger"

>              <ajwdct@technolog
To
>              ist.com>                  wsrf@lists.oasis-open.org

>
cc
>              06/08/2004 20:09          dirceu@ccrl.sj.nec.com,

>                                        tatemura@ccrl.sj.nec.com

>
Subject
>                                        [wsrf] Some Thoughts on WSRF61:

>                                        WS-RF Primer/App Note/Usage Notes

>

>

>

>

>

>

>
>
>
>
> Following our f2f meeting of July 27-28, we decided it would be a good
idea
> to write a non normative document on how to use the WS-RF family of
specs.
> We were not sure what to call it: Primer/App Note/Usage Notes/ Best
> Practices document. For now, I will refer to it as "App Note." Brian was
> good enough to add this to the issues list as WSRF61 and I am responsible
> for this issue.
>
>
> While I volunteered to work on the document and believe it is quite
> important, I am not funded for this activity.  Hence, the time I can
spend
> on it is somewhat limited.   The purpose of this mail is to stimulate
> interest in the document and solicit others to work on it with me.
>
>
> In my opinion we need to provide the following content in the App Note
> document:
>
>
> -Overview of the WS-RF specs: WS-RP, WS-RL, WS-BF, WS-SG, WS-Renewable
> References
>
>
> (suggest one or two paragraphs for each spec description)
>
>
> -Potential applications, e.g. examples of web services that contain
> stateful resources (behind the WS interface), Grid Infrastructure layer
> (along with WS-DM and WS-Notification specs), other WS specs (e.g. WSDM,
> WS-Notification) that might make use of WSRF specs
>
>
> -Definitions of various terms: WS Resource, Implied Resource Pattern,
> Factory Pattern, etc (we can extract information from the two whitepapers
(
> The WS-Resource Framework and Modelling Stateful Resources with Web
> Services)
>
>
> -How the WS RF specs compose, i.e. are used together (including any
> dependencies and interactions).
>
>
> -Best Practices: clarification of nillable properties* and other items,
> interpretation of fault messages and potential recovery options, policy
> issues
>
>
> -Any issues from the WSRF issues list that we feel is implementation
> dependent (and therefore non normative/ not subject to standardization)
>
>
> -How WS-RF specs could be used with WS-Notification specs (as per Peter
> Niblett's presentation to both TCs at f2f meeting)
>
>
> -How WS-DM specs (MUWS and MOWS) make use of WS-RF specs (input from WSDM
> TC would be appreciated).
>
>
> -How WS-RF specs could make use of WS-Security and WS-Reliable Messaging/
> WS Reliability
>
>
>
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------

>
>
> *  We specifically stated that Issue WSRF48: Specify behavior of nillable
> properties was a candidate for the App Note/Primer. "This should be
> clarified or described as a best practice in the Primer, should we decide
> to write a Primer."
>
>
>
> Any comments, suggestions, ideas?
> Alan Weissberger
>
> 1 408 863 6042 voice
>
> 1 408 863 6099 fax
>
>
>

OGSI Primer Index Pages.pdf