[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: ISSUE 35: Confusing words in Section 5.3 relating to Conversational Intent
http://www.osoa.org/jira/browse/ASSEMBLY-35 On Dec 17, 2007, at 2:54 AM, Mike Edwards wrote: > > RAISER: Mike Edwards > > TARGET: SCA Assembly specification > > DESCRIPTION: > > In the assembly specification, WD-01, the paragraph between lines > 860 and 864 dealing with conversational interfaces > is confusing and should be rewritten to clarify its meaning and > properly describe normative requirements. > > The current text is as follows: > > "This specification requires interfaces to be marked as > conversational by means of a policy intent with the name > "conversational". The form of the marking of this intent depends > on the interface type. Note that it is also possible > for a service or a reference to set the conversational intent when > using an interface which is not marked with the > conversational intent. This can be useful when reusing an existing > interface definition that does not contain SCA > information." > > It is left unclear > - what is required on the interface itself (is marking mandatory?) > - where the marking is described and what form it may take > - the relationship between specifying the conversational intent on > the service/reference and specifying it on the > interface itself. > > > PROPOSAL: > > Replace the paragraph between lines 860 and 864 with the following: > > "There is a policy intent with the name conversational which is > used to mark an interface as being conversational > in nature. Where a service or a reference has a conversational > interface, the conversational intent MUST be > attached either to the interface itself, or to the service or > reference using the interface. How to attach the > conversational intent to an interface depends on the type of the > interface. For a WSDL interface, this is described > in section 5.4 "SCA-Specific Aspects for WSDL Interfaces". For a > Java interface, it is described in the Java > Common Annotations and APIs specification. Note that setting the > conversational intent on the service or reference > element is useful when reusing an existing interface definition > that contains no SCA information, since it requires no > modification of the interface artifact." > > > > 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 > > > > > >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]