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


Help: OASIS Mailing Lists Help | MarkMail Help

sca-bindings message

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

Subject: Re: [sca-bindings] ISSUE-61: Conformance statement numbering

Logged as http://www.osoa.org/jira/browse/BINDINGS-61 for binding.ws specification.


Simon Holdsworth wrote:
OFA6EB9490.CC28F8F5-ON80257539.004635D0-80257539.00472F64@uk.ibm.com" type="cite">
TARGET: ws, jms and jca binding cd01 (1 issue each)


Each binding specification needs to include in the conformance section a list of conformance requirements.  These need to be extracted from the text of the specification.


Following the precendent of the Assembly specification:

Number every conformance statement in each binding spec.  Use the following numbering scheme:


ppp = spec prefix, BWS for web service binding, BJM for JMS binding, BJC for JCA binding
s = section number
n = index number within section

Add such a number to every statement in each spec that includes RFC2119 keywords.

Construct a table in the conformance section with two columns.  
First column contains the conformance statement number, linked to the position in the spec text where the statement appears.
Second column contains the conformance statement text, linked to the position in the spec text where the statement appears.

Update the conformance statements within the specification text so that the conformance statement text and number are references to the entries in the table.

Possible extra credit: apply some subtle highlighting to each conformance statement (very light grey background?) that gives a visual indication of the start and end of the conformance statement.

Simon Holdsworth
STSM, SCA Bindings Architect; Master Inventor; OASIS SCA Bindings TC Chair
MP 211, IBM UK Labs, Hursley Park, Winchester SO21 2JN, UK
Tel +44-1962-815059 (Internal 245059) Fax +44-1962-816898
Internet - Simon_Holdsworth@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]