[NEW ISSUE]: Section 7.1 of the Java CAA Specification is unclear

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

Raiser: Mike Edwards

Target: Java Common Annotations and
APIs specification WD-03

Description:

Section 7.1 of the CAA specification
describes the Component Context API.

This API has several methods with various
parameters and return values.  
The descriptions of these methods are
all very brief and do not adequately describe preconditions,
postconditions, nor adequately describe
the parameter values and return values for  the methods.

The lack of clarity and detail means
that implementers and users of the API cannot be sure what is
expected from each method.

Proposal:

None at present.


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