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

 


Help: OASIS Mailing Lists Help | MarkMail Help

sca-assembly message

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


Subject: Re: [sca-assembly] Some review comments on sca-assembly-1.1-spec-cd02-Rev3.pdf


Responses inline in <vamsi> tags.

++Vamsi
Apache Tuscany Committer  http://tuscany.apache.org
Apache Geronimo Committer and Member of PMC  http://geronimo.apache.org



                                                                       
             Mike Edwards                                              
             <mike_edwards@uk.                                         
             ibm.com>                                                   To
                                       C Vamsi/India/IBM@IBMIN         
             11/02/2009 14:52                                           cc
                                                                       
                                                                   Subject
                                       Re: [sca-assembly] Some review  
                                       comments on                     
                                       sca-assembly-1.1-spec-cd02-Rev3.pdf
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       
                                                                       




Vamsi,

Sorry for missing the earlier set of comments.

Responses inline and updates included in new Rev4 version of spec.

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:        C Vamsi <vamsic007@in.ibm.com>                           
                                                                       
 To:          Mike Edwards/UK/IBM@IBMGB                                
                                                                       
 Cc:          "OASIS Assembly" <sca-assembly@lists.oasis-open.org>     
                                                                       
 Date:        10/02/2009 17:35                                         
                                                                       
 Subject:     Re: [sca-assembly] Some review comments on               
              sca-assembly-1.1-spec-cd02-Rev3.pdf                      
                                                                       






Mike,

I will raise new issues as per your comments.  There are more comments (the
first set actually) in an e-mail that I sent before the one you acted on.
See [1]

[1] http://lists.oasis-open.org/archives/sca-assembly/200902/msg00005.html

++Vamsi
Apache Tuscany Committer  http://tuscany.apache.org
Apache Geronimo Committer and Member of PMC  http://geronimo.apache.org



            Mike Edwards
            <mike_edwards@uk.
            ibm.com>                                                   To
                                      "OASIS Assembly"
            10/02/2009 22:47          <sca-assembly@lists.oasis-open.org>
                                                                       cc

                                                                  Subject
                                      Re: [sca-assembly] Some review
                                      comments on
                                      sca-assembly-1.1-spec-cd02-Rev3.pdf










Vamsi,

I'm sorry for missing your comments ahead of the call.  I've had a proper
look at them now and I've
acted on them as described inline...

I incorporated the changes into an updated Rev4 along with the 3 editorial
fixes from the TC call today.

If anyone has any problems with these editorial fixes, please shout now!


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:       C Vamsi <vamsic007@in.ibm.com>

To:         C Vamsi <vamsic007@in.ibm.com>

Cc:         sca-assembly@lists.oasis-open.org

Date:       04/02/2009 20:55

Subject:    Re: [sca-assembly] Some review comments on
            sca-assembly-1.1-spec-cd02-Rev3.pdf







Some more comments:

Line 870: 4.3.1 instead of 5.3.1?

Updated as an editorial fix

Section 4.4 name should be Component Property?

No - the whole section is "Component" and this is a subheading

Line 1064: @name attribute

Fixed as an editorial

Line 1064-1066: Should the wording be made consistent with that of service
and reference elements?

I think that's a subject for an Issue

Line 1078: change to "Overrides the many specified for this property in the
component type of the implementation."

Fixed as an editorial

Lines 1152-1154: Multiple property elements with same property name is a
violation of "[ASM50030]"

I agree.  That's a subject for an issue.

Line 1157: stockQuoteService with a small s

Fixed as an editorial

Line 1166: stockQuoteService with a small s

Fixed as an editorial

++Vamsi
Apache Tuscany Committer  http://tuscany.apache.org
Apache Geronimo Committer and Member of PMC  http://geronimo.apache.org



            C
            Vamsi/India/IBM@I
            BMIN                                                       To
                                      sca-assembly@lists.oasis-open.org
            05/02/2009 01:26                                           cc

                                                                  Subject
                                      [sca-assembly] Some review comments
                                      on
                                      sca-assembly-1.1-spec-cd02-Rev3.pdf









I have reviewed the document partially and here are some comments on
sca-assembly-1.1-spec-cd02-Rev3.pdf:

Line 212: component with small c

Fixed - editorial

Line 225: us xs:QName for consistency

Fixed - editorial

Line 245: What does implementation 0..1 mean?

Means that  <implementation/> is optional with maxOccurs=1

Line 377: "zero or more" in bold font.

Fixed - editorial

Line 431-432: Change to "The implementation can use the supplied value in
any way that it chooses."

Fixed - editorial

Section 3.1.4 does not talk about 0..1 for implementation

It has a "?" in the pseudo-schema
<vamsi>
Other subsections in the section explicitly say in the descriptive text
about the respective multiplicity. So, I was wondering if it should be done
for this subsection as well.
</vamsi>

Line 464: implementation instead of implementationervice

Fixed - editorial

Line 508: tags or annotations?

Fixed - editorial

Should example in 3.3 use @Service annotation as well?

It does not have to

Line 578: Should the componentType have implementation.java tag as it is
computed from the java class?

No

Line 596: Is it possible to get the default value for the field by
introspection?

No, it isn't - this needs fixing via an issue

Line 600: "Component Implementation" spec instead of "Client and
Implementation" spec?

Yes, Fixed - editorial - also removed reference to "SCA Example Code
document"

Line 607-608: Not true for Java EE

I don't understand this comment.  There does not appear to be a problem
with those lines.
<vamsi>
More than one component can use and configure the same implementation,
where each component configures the implementation differently. -- More
than one component can not use implementation.ejb to configure the same EJB
as component implementation
</vamsi>

Line 609: in xxx.composite is xxx needed?

"xxx" indicates that some kind of file name is required
<vamsi>Instead of xxx.composite, can we say "a file with .composite
extension"? That is what we do for componentType files etc.</vamsi>

Section 4.1 name should be Component Implementation?

I take the view that this is implied by the Section 4 heading which is
"Component"

Section 4.2 name should be Component Service?

Ditto

Section 4.3 name shoulde Component Reference?

Ditto

Lines 791-792: replace 2 occurrences of "service" with "reference".

Fixed - thanks for spotting that - the error was actually in the appendix C
section that
holds all the normative statements.

I will post more comments as I review further.  I would like to know if I
need to raise NEW ISSUE for some of these.

++Vamsi
Apache Tuscany Committer  http://tuscany.apache.org
Apache Geronimo Committer and Member of PMC  http://geronimo.apache.org


---------------------------------------------------------------------
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




---------------------------------------------------------------------
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



















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










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