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

Simon,

Rather than forcing every reviewer to
create a diff document, it would be wise to produce one as part of the
process

of creating CD-02 - ie have a clean
CD-02 AND a diff version showing all changes vs CD-01 - publish both

and ask the reviewers to make use of
the diff to confirm the changes.  MS Word will create a diff document
if

you ask it to, so this is no great burden.

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:  

From:
Simon Holdsworth/UK/IBM@IBMGB

To:

Cc:
"OASIS Bindings" <>

Date:
17/12/2008 12:04

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

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 -  

Mike Edwards/UK/IBM@IBMGB

16/12/2008 09:42

To

"OASIS Bindings"
<> 

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:   

From:

Simon Holdsworth/UK/IBM@IBMGB

To:



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 - 

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 

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