Re: [sca-j] Java CAA Spec - CD02 Rev6, containing all latest resolvedissues - and now CD02 Rev 7 !!

[Simon Nash <oasis@cjnash.com>]

My comments are in the attached Word file.  Most are editorial,
though there may be a few that require issues.

Warning: there are a large number of comments - apologies!

   Simon

Mike Edwards wrote:
> 
> Mark,
> 
> 2 issues raised.  Most of your comments acted on - there are a couple of 
> editorials that I did not agree with and have
> left unchanged.
> 
> CD02 Rev7 published:
> 
> http://www.oasis-open.org/apps/org/workgroup/sca-j/download.php/32324/sca-javacaa-1.1-spec-cd02-rev7.pdf 
> 
> http://www.oasis-open.org/apps/org/workgroup/sca-j/download.php/32323/sca-javacaa-1.1-spec-cd02-rev7.doc 
> 
> 
> 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: 	"Mark Combellack" <mcombellack@avaya.com>
> To: 	Mike Edwards/UK/IBM@IBMGB, "OASIS Java" <sca-j@lists.oasis-open.org>
> Date: 	29/04/2009 15:28
> Subject: 	RE: [sca-j] Java CAA Spec - CD02 Rev6, containing all latest 
> resolved issues
> 
> 
> ------------------------------------------------------------------------
> 
> 
> 
> Hi,
>  
> I have the following review comments on this document. The line numbers 
> are based on the PDF version:
>  
> *Editorial comments*
>  
> 
>     * Front page – The chairs section is inconsistent with the C&I document
>     * Notices page – copyright year should include 2009
>     * Line 2: Wrong document title – It should be “SCA Java Common
>       Annotations and APIs”
>     * Inconsistent indentation on the following lines:
> 
> ·         23-25
> ·         320-331
> ·         803
> ·         1013
> ·         2185 – 2186
> ·         2456 – 2514
> ·         2520 - 2554
> 
>     * Lines 29-34: Should we refer to the latest Assembly PR and Java
>       C&I documents?
>     * Line 382 – Change “injecting references or properties” to
>       “injecting properties or references” since properties are injected
>       before references
>     * Lines 466 – Change “Nonblocking” to “Non-blocking” to be
>       consistent with the other uses of “non-blocking” in that section
>       (lines 466, 474 and 476)
>     * Lines 519, 526 & 570: (Not being American so I could be wrong) – I
>       thought it was ZIP code and not zip code. If I am correct, need to
>       change occurrences of zip to ZIP in these lines
>     * Line 588 – There is no section 6.7.1
>     * Line 635 – Split into two lines as it is easy to misread it and
>       think the @Context annotation applies to the someMethod() method
>     * Line 927 & 958 – We are inconsistent with how we number our
>       examples. This probably applies to the whole document
>     * Line 1319 – This is a normative statement that has not have a
>       conformance number
>     * Line 1463 – section references of 8.14 and 8.15 are wrong. It
>       should be 10.15 and 10.17
>     * Lines 2354 – 2356 – Remove this paragraph as this is a duplication
>       of the text from sections 2.2.1 and 2.2.2. We should just update
>       the text to refer back to them rather than duplicating them
>     * Line 2585 – Could we make the Conformance ID column in the table
>       narrower since there is a lot of empty whitespace between the
>       columns. We don’t need quite so much
>     * Lines 2591 – 2593 – Copy acknowledgements from the C&I spec as
>       Dave has updated them.
>     * Lines 2596 – 2598 – Should we remove these before going to PR?
> 
>  
> *Probably new issues*
> 
>     * Lines 487 – 489: Should there be a normative statement associated
>       with this? It suggests that there is one in Assembly but should we
>       be explicit here in the Java specifications?
>     * Lines 646 – 647: Should there be a normative statement for this
>       either here or in section 10.3?
> 
>  
> Thanks,
>  
> Mark
> Mark Combellack| Software Developer| Avaya | Eastern Business Park | St. 
> Mellons | Cardiff | CF3 5EA | Voice: +44 (0) 29 2081 7624 | 
> _mcombellack@avaya.com_ <mailto:|mcombellack@avaya.com>
> 
> ------------------------------------------------------------------------
> 
> *From:* Mike Edwards [mailto:mike_edwards@uk.ibm.com] *
> Sent:* 28 April 2009 08:54*
> To:* OASIS Java*
> Subject:* [sca-j] Java CAA Spec - CD02 Rev6, containing all latest 
> resolved issues
>  
> 
> Folks,
> 
> CD02 Rev6 of the Java CAA spec is available here:
> _
> __http://www.oasis-open.org/apps/org/workgroup/sca-j/download.php/32273/sca-javacaa-1.1-spec-cd02-rev6.pdf_ 
> _
> __http://www.oasis-open.org/apps/org/workgroup/sca-j/download.php/32272/sca-javacaa-1.1-spec-cd02-rev6.doc_ 
> 
> 
> This version of the spec is a candidate for CD03 and for Public Review - 
> please review carefully.
> 
> 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
> 
> ------------------------------------------------------------------------
> 
>  
> 
> /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/
> 
> 
> 
> 
> 
> 
> 
> 
> ------------------------------------------------------------------------
> 
> /
> /
> 
> /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-javacaa-1.1-spec-cd02-rev7+simon.doc