Re: [sca-assembly] Recommendation on Conformance Targets and RFC 2119Wording from OASIS SCA Liaison subcommittee

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

Duane,

Be careful what you volunteer for  
;-)

I have a more radical suggestion for
the TC (and for the editors) regarding conformance statements:

- Each conformance statement should
be identified by a unique Tag or Label and should be formatted in such
a way that it clearly stands out on
the page.  

My preference is for a two part number
tag like 3.10.  Ideally the first number would relate to the major
section of 
the spec containing the statement.  The
second is simply a count.

- I'd favour marking the tagged conformance
statements with special formatting, such as follows:

My reasoning for this approach is that
we need to have a way to link conformance statements to elements of the
test suite.  Without labelling,
this is very hard.


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

Duane Nickull <dnickull@adobe.com>

14/01/2008 16:51

To	Mike Edwards/UK/IBM@IBMGB, OASIS Assembly <sca-assembly@lists.oasis-open.org>
cc
Subject	Re: [sca-assembly] Recommendation on Conformance Targets and RFC 2119 Wording from OASIS SCA Liaison subcommittee

Mike:


On 1/14/08 8:42 AM, "Mike Edwards" <mike_edwards@uk.ibm.com>
wrote:

We recommend that each TC write its specifications
to: 
1. Reword the specifications using RFC 2119 keywords. 
2. For each appearance of a 2119 keyword, specify the document, construct
or runtime behavior that is being constrained." 

Does this infer someone needs to peruse each document and make a master
list of all “MUST”, “MUST NOT” etc... once the specifications are re-written?
 I’ll volunteer for this if you want an owner.

Duane

-- 
**********************************************************************
"Speaking only for myself"
Senior Technical Evangelist - Adobe Systems, Inc.
Blog - http://technoracle.blogspot.com
Community Music - http://www.mix2r.com
My Band - http://www.myspace.com/22ndcentury
Adobe MAX 2008 - http://technoracle.blogspot.com/2007/08/adobe-max-2008.html
**********************************************************************

---

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