Re: [sca-j] ISSUE-107: RFC2119 Language is needed for the EJB BindingSpecification - proposal v2 - REVIEW

[Mike Edwards <mike_edwards@uk.ibm.com>]

Dave,

Here is a review of the proposal - couple
of errors found, plus some requests for extra normative statements:



Yours,  Mike.

Strategist - Emerging Technologies, SCA & SDO.
Co Chair OASIS SCA Assembly TC.
IBM Hursley Park, Mail Point 146, Winchester, SO21 2JN, Great Britain.
Phone & FAX: +44-1962-818014    Mobile: +44-7802-467431  
Email:  mike_edwards@uk.ibm.com

From:	David Booz <booz@us.ibm.com>
To:	sca-j@lists.oasis-open.org
Date:	24/07/2009 13:58
Subject:	Re: [sca-j] ISSUE-107: RFC2119 Language is needed for the EJB Binding Specification - proposal v2

---

Thanks for the feedback and the quick review.

I've moved BSB80001 into 8.1 and reworked accordingly so TC members can
see what that looks like.

On your point about not labelling the MUST in section 8. Let's talk about
this on the call today, because I'd like to understand the rationale. I
had never noticed (before doing this EJB binding spec) that none of the
conformance sections we've written to date had those MUSTs labelled. That
seemed odd to me (because it seems inconsistent) so Mike E and I had a
discussion. Turns out, he is intending to label the statements in the assembly
spec, so I did the same here.

(See attached file: sca-ejbbinding-1.1-spec-wd-04+issue107_v2.doc)

Dave Booz
STSM, BPM and SCA Architecture
Co-Chair OASIS SCA-Policy TC and SCA-J TC
"Distributed objects first, then world hunger"
Poughkeepsie, NY (845)-435-6093 or 8-295-6093
e-mail:booz@us.ibm.com

Anish
Karmarkar ---07/24/2009 01:58:52 AM---One minor feedback: Instead of BSB80001
we should add a requirement in 8.1 that says that an

From:	Anish Karmarkar <Anish.Karmarkar@oracle.com>
To:	sca-j@lists.oasis-open.org
Date:	07/24/2009 01:58 AM
Subject:	Re: [sca-j] ISSUE-107: RFC2119 Language is needed for the EJB Binding Specification - proposal v1

---

One minor feedback:

Instead of BSB80001 we should add a requirement in 8.1 that says that an
SCA EJB SBB XML doc must conform to the schema. Then BSB8005 would cover
BSB80001. The advantage of adding that requirement is that then the 
requirement is on the document.
(I know what you have done is exactly what we did for other bindings. So
it would have to be fixed there as well).

Also, the musts in section 8 should not be labeled.

-Anish
--

David Booz wrote:
> Here are the links to version1 of a proposal to add RFC2119 keywords
to 
> the EJB binding spec. Please take a look, there's not that much to
> review. There are a couple of things to note:
> 
> 1) I included a conformance section in this proposal, so we can reject
> the new issue I opened for this purpose.
> 
> 2) My approach was to search for all RFC2119 keywords and update the
> spec accordingly. As a result, there are only two (yes 2) labelled
> statements in the body of the spec. I'm fairly sure that's not enough,
> so this document needs another pass to try to pick out statements
that 
> need to be made normative, but which don't currently contain any RFC2119
> words. I will make a pass at this in a separate version of the document.
> For now, I'd appreciate a review of what I've done, you can easily
see 
> in this version what I've done with the existing text and the usage
of 
> each RFC2119 keyword. Feedback on this level of document is appreciated
> so that I can be sure I have a good base for further analysis.
> 
> http://www.oasis-open.org/committees/download.php/33489/sca-ejbbinding-1.1-spec-wd-04%20issue107_v1.pdf
> 
> http://www.oasis-open.org/committees/download.php/33490/sca-ejbbinding-1.1-spec-wd-04%20issue107_v1.doc
> 
> 
> Dave Booz
> STSM, BPM and SCA Architecture
> Co-Chair OASIS SCA-Policy TC and SCA-J TC
> "Distributed objects first, then world hunger"
> Poughkeepsie, NY (845)-435-6093 or 8-295-6093
> e-mail:booz@us.ibm.com
> 

---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php


[attachment "sca-ejbbinding-1.1-spec-wd-04+issue107_v2.doc"
deleted by Mike Edwards/UK/IBM] ---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php

---

Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU

sca-ejbbinding-1.1-spec-wd-04+issue107_v2_mje.doc