Re: [sca-bindings] Updates to specs, revision bars

[Simon Holdsworth <simon_holdsworth@uk.ibm.com>]

Mike,

OK, so it sounds like there is not an
issue with the existing cd01-revN documents (assuming all applied issue
resolutions are listed in the appendix), and that reviewers should not
rely on any revision marking within the document, but rather diff the CD
candidate document against the previous CD.

Regards, Simon

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

Mike Edwards/UK/IBM@IBMGB

16/12/2008 09:42

To	"OASIS Bindings" <sca-bindings@lists.oasis-open.org>
cc
Subject	Re: [sca-bindings] Updates to specs, revision bars

Simon, 

I'm with Eric on this one. 

When we're ready with CD02, you can create a diff of that document against
CD01 which will show all the changes between the 
two versions.  This should enable reviewers to check everything that
has been done.  It is more important to keep a list of all the
Issue resolutions that have been applied between the two versions, so that
they can be checked off by the reviewers - enabling
all those issues to be moved from "Applied" state to "Closed"
state,,, 

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

From:	Simon Holdsworth/UK/IBM@IBMGB
To:	sca-bindings@lists.oasis-open.org
Date:	15/12/2008 11:18
Subject:	[sca-bindings] Updates to specs, revision bars

---

Folks, 

There were some concerns regarding spec revisions and naming that was used
for the bindings specs when working on the RFC2119 resolution.  I
understand that versions of the specs that contain proposed resolutions
should not be named -cd01-revN.doc, but rather that a separately named
document should be used to work on the resolution, which is then added
to a revision of the spec document once resolved. 

The problem that we now have is that we have gone through multiple revisions
as we sorted out the various specs, with changes accepted in between, so
that the latest revisions of the JCA and WS specs, at least, don't have
all changes since the last CD marked with revision bars.

I'd like to get some feedback from the TC on how we proceed from here.

Is the expectation that between CD versions, the changes in the -revN documents
mount up, and only get accepted when we move to the next CD, or is it OK
to accept changes from revN to revN+1 ? ("accept changes" in
the Microsoft word sense, rather than any TC sense).

If it is the latter, then we are OK to carry on from where we are.
If the former, then we have to do one of the following:

A) fix up the latest spec documents so that they show all changes since
cd01. 
B) accept the latest spec documents as CD02, and use that as the base for
applying further revisions. 
C) understand that when we do get to CD02, some of the changes made for
RFC2119 statements will not be marked with revision bars.

Regards, Simon 

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

---

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