OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

ws-sx message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [ws-sx] Further discussion on WS-SX Examples document


Examples are invaluable to implementers and deployers.

The expertise of this group will be lost once we shut down, so there is no
better time to document what we are thinking.


On 6/12/07 7:32 AM, "Raepple, Martin" <martin.raepple@sap.com> wrote:

> +1. 
> Developers prefer code samples to learn new programming languages. I
> think the same is true for meta data languages like SP.
> Martin
>> -----Original Message-----
>> From: Prateek Mishra [mailto:prateek.mishra@oracle.com]
>> Sent: Samstag, 9. Juni 2007 00:21
>> To: ws-sx@lists.oasis-open.org
>> Subject: [ws-sx] Further discussion on WS-SX Examples document
>> This message responds to the following questions from the May 30
>> conference call minutes:
>> [quote]
>>   1. Is an examples document in scope of the TC?
>>   2. What specific examples are or are not in scope in an examples
>> document?
>>    3. What additional work or steps are required before the examples
>> doc can progress to CD?
>> [\quote]
>> 1. The starting point of the examples document goes back to
>> May 2006 when
>> this work was proposed by Ashok Malhotra[1]. The points made then were
>> that the
>> SecurityPolicy specification is quite complext (111 pages in its final
>> incarnation)
>> and that most people would have a difficult time figuring out even
>> simple example policies.
>> The idea was to collect examples with explanations, this would provide
>> readers a
>> starting point for many scenarios of interest.
>> I think the question of whether such a document is "in scope" is
>> actually ill-posed.
>> A more appropriate question would be: is it appropriate to publish a
>> complex standard like
>> SecurityPolicy without an examples document?
>> The examples are needed as a kind of sanity-test so that we
>> can see how 
>> SecurityPolicy
>> features may be used to secure message exchanges in a few cases of
>> interest to the TC.
>> Aside from the educational and labor-saving aspects, it is also a
>> indication of openness in that
>> readers need not purchase proprietary products in order to understand
>> the use of
>> the SecurityPolicy specification.
>> Finally, if we look at comparable specifications like
>> W3C XML Schema we find them accompanied by a systematic and detailed
>> primer document.
>> 2. The examples document has been quite extensively reviewed
>> by many TC 
>> members
>> and many suggestions for change have been made and implemented.
>> If any vendor has a specific concern with a particular example, they
>> should explain what this is
>> and I am sure the Editors would update the document appropriately.
>> 3. I believe that as soon as any remaining open issues are
>> resolved, we 
>> should conduct a
>> CD vote for the document.
>> ------------------------------------------------------
>> [1] http://lists.oasis-open.org/archives/ws-sx/200604/msg00031.html

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]