Re: [sca-bindings] Proposed resolution to issue BINDINGS-147

Bryan,

Apologies, I've enabled line numbering.
 I'm not too familiar with working with ODT files, I've had a few
issues with formatting.

Another observation.  Currently
the JMS TC document TA appendix has a comment in each entry with a copy
of the normative statement from the JMS spec.  This was very convenient
when building and reviewing the TAs, however I'm not sure that we should
have these statements copied into the Test Cases document, and I expect
this is not consistent with any other Test Case document.  I believe
we should remove these statements from the comments.

Here's an updated proposal (with your
requested changes, but currently without the TA comments removed):

Simon Holdsworth

From:      
 Bryan Aupperle <>

To:      
 

Date:      
 11/03/2011 19:22

Subject:    
   Re: [sca-bindings]
Proposed resolution to issue BINDINGS-147

While we are doing this, we should fix
some RFC2119 related wording problems.  These are now all in section
A.1: 

There are no line numbers to use so... 

  

Prerequisites: The prerequisites *may* be defined in terms of one or more
other test assertions that *must* be true. 

Predicate: The meat of the assertion - something that *should evaluate*
to true or false for the given target.         (We
missed this in the POJO document) 

Prescription Level: Mandatory (for *MUST* requirements) or Preferred (for
*SHOULD* requirements) or Permitted (for *MAY* requirements). 

Tags: Zero or more labels *that may* be attached to this test assertion
- these tags can be used to group sets of assertions. 

Should changed to 

Prerequisites: The prerequisites *can* be defined in terms of one or more
other test assertions that *have to* be true. 

Predicate: The meat of the assertion - something that *evaluates* to true
or false for the given target.    (Also fix in the POJO document)

Prescription Level: Mandatory (for *"MUST"* requirements) or
Preferred (for *"SHOULD"* requirements) or Permitted (for *"MAY"*
requirements). 

Tags: Zero or more labels *to be* attached to this test assertion - these
tags can be used to group sets of assertions. 

Bryan Aupperle.

Software IT Architect - Mid-Atlantic

Senior Technical Staff Member

Raleigh, NC

Mobile: 919-656-0018

 

From:        Simon
Holdsworth <> 

To:        Mike
Edwards <> 

Cc:        

Date:        03/11/2011
09:35 AM 

Subject:        Re:
[sca-bindings] Proposed resolution to issue BINDINGS-147

Mike, 

OK, I think actually I'd prefer to put the TA to TC mapping after the TAs,
so we have: 

App A TA 

App B Normative statement to TA mapping 

App C TA to TC mapping 

Here's another update with the mapping section moved to an appendix, and
subsections added in section 2: 

Simon Holdsworth

STSM, SCA Bindings Architect; Master Inventor; OASIS SCA Bindings TC Chair,
AT&T and Boeing Lab Advocate

MP 211, IBM UK Labs, Hursley Park, Winchester SO21 2JN, UK

Tel +44-1962-815059 (Internal 245059) Fax +44-1962-816898

Internet -  

From:        Mike
Edwards/UK/IBM@IBMGB 

To:        

Date:        11/03/2011
14:00 

Subject:        Re:
[sca-bindings] Proposed resolution to issue BINDINGS-147

Simon, 

You did this really quickly and I'm impressed!  It looks pretty good.

A couple of comments inline below...

Yours, Mike 

Dr Mike Edwards

 Mail Point 137, Hursley
Park 

STSM

 Winchester, Hants SO21
2JN 

SCA & Services
Standards 
 United Kingdom

Co-Chair OASIS SCA
Assembly TC 
 

IBM Software Group

  

Phone:

+44-1962 818014

  

Mobile:

+44-7802-467431 (274097)

  

e-mail:



  

 

 

From:

Simon Holdsworth/UK/IBM@IBMGB

To:



Date:

11/03/2011 12:45

Subject:

[sca-bindings] Proposed resolution to
issue BINDINGS-147

Proposed resolution to BINDINGS-147, "Conformance Statement missing
for the Web Services Binding Assertions" 

Please review and comment on these changes, I'd like at least some feedback
on this one before I got ahead and do the web services proposal.

Summary: 

Include test assertions content in an appendix of the test cases document;
remove normative reference to TA document, update descriptive text to reference
the new appendix. 

Detail: 

Here's a modified version of the JMS test cases document with the proposed
changes: 

Comments: 

The resulting document has a section 3, "Cross Mapping of Test Assertions
to TestCases", but then the mapping from test assertions to normative
statements is in an appendix A.6 "Cross Mapping of Conformance Statements
to Test Assertions", which seems inconsistent to me, I would have
expected all cross-mappings to be in appendices. Also really I think that
appendix title should be "Cross Mapping of Normative Statements to
Test Assertions", they are not conformance statements.

<mje> 

Agreed.  We can move Section 3 into Appendix A and move the Appendix
A into Appendix B ? 

</mje>

The testCases section has a subsection "Section 3" which I assume
refers to the SCA JMS Binding Specification Section 3....   in which
case the Test Cases section 2 should have additional subsections relating
to the SCA JMS Binding Specification Section 4, 5 and 6, as the TA Appendix
does. 

<mje> 

Yes, agreed - this subsection arrangement is what we have in other testcase
documents 

</mje>

At the risk of begging extra work, it seems like all these cross mapping
sections should have the mapped elements be cross-referenced in the document
to enable navigation... 

<mje> 

Ahem  --- that is a *lot* of extra work you're asking for.  Don't
go there unless you've got a spare weekend coming up...

</mje>

Regards, Simon 

Simon Holdsworth

STSM, SCA Bindings Architect; Master Inventor; OASIS SCA Bindings TC Chair,
AT&T and Boeing Lab Advocate

MP 211, IBM UK Labs, Hursley Park, Winchester SO21 2JN, UK

Tel +44-1962-815059 (Internal 245059) Fax +44-1962-816898

Internet - 

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 

[attachment "sca-jmsbinding-1.1-testcases-1.0-issue147.odt" deleted
by Mike Edwards/UK/IBM] [attachment "sca-jmsbinding-1.1-testcases-1.0-issue147.pdf"
deleted by Mike Edwards/UK/IBM] ---------------------------------------------------------------------

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 

[attachment "sca-jmsbinding-1.1-testcases-1.0-issue147-v2.odt"
deleted by Bryan Aupperle/Raleigh/IBM] [attachment "sca-jmsbinding-1.1-testcases-1.0-issue147-v2.pdf"
deleted by Bryan Aupperle/Raleigh/IBM] ---------------------------------------------------------------------

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

sca-jmsbinding-1.1-testcases-1.0-issue147-v3.odt

sca-jmsbinding-1.1-testcases-1.0-issue147-v3.pdf