RE: [sca-j] Java CI spec - up to date issues applied

[David Booz <booz@us.ibm.com>]

There seem to be some indentation/formatting differences between the word and pdf formats and some strange interactions between pdfmaker and print to pdf. Believe it or not, when I run pdfmaker over this document, it just dies right at the end and doesn't produce a pdf file. When I try to print to pdf, the word file is actually modified (which screws up the formatting) making the word and pdfs different (but only in formatting, not in content). I'm frustrated and am giving up for now on the formatting situation as I don't know how to resolve it. If someone else can look at this, I'd appreciate it.

Now as for the comments:
- I could not figure out how to (reliably) indent all text under the major headings, so instead I un-indented everything to match chaps 8-11. In trying to make Chap 8 indented like the rest of the document, all kinds of strange formatting problems cropped up, so that's why I decided to un-indent everything. This had the effect of changing line numbers all over the place.

For the remaining comments, using the line numbers from your email, this leaves:
-779, 827 which I fixed
- 65, 96 are the only ones that need the package definition so I only added those two.
- 234, fixed
- 295, 306 fixed
- 908 fixed

I left change tracking on for wd10 and did NOT accept wd09 updates, so marked changes include those made in wd09.

http://www.oasis-open.org/committees/download.php/32340/sca-javaci-1.1-spec-wd10.doc

I did not produce a pdf as a result of the aforementioned formatting problems.


Dave Booz
STSM, BPM and SCA Architecture
Co-Chair OASIS SCA-Policy TC and SCA-J TC
"Distributed objects first, then world hunger"
Poughkeepsie, NY (845)-435-6093 or 8-295-6093
e-mail:booz@us.ibm.com

"Mark Combellack" ---04/30/2009 08:21:17 AM---Hi Dave,

From:	"Mark Combellack" <mcombellack@avaya.com>
To:	David Booz/Poughkeepsie/IBM@IBMUS, <sca-j@lists.oasis-open.org>
Date:	04/30/2009 08:21 AM
Subject:	RE: [sca-j] Java CI spec - up to date issues applied

---

Hi Dave,
 
I have reviewed the updated WD09 of the C&I specification and have the following review comments:
 
Editorial Comments

• Inconsistent indentation on the following lines:
  · Lines 2 – 11
  · Lines 13 – 15
  · Line 45
  · Lines 267 – 271
  · Lines 281 – 283
  · Lines 373 – 650 – i.e. whole of chapter 8
  · Lines 676 – 803 – i.e. whole of chapter 10
  · Lines 779 – 791 – Consider indenting this list further than the paragraphs that surround it
  · Lines 827 – 841 - Consider indenting this list further than the paragraphs that surround it
• Lines 65, 71, 96 & 121: Add “package services.hello;” since composite XML in lines 83 – 90 has a package name
• Line 234: Change method name to setMaxRetries to match the variable name. Not strictly required but do we really need to introduce an example at this point that shows different method names/field names?
• Split the code comments on the following lines onto multiple lines as it splits in an untidy way:
  · Lines 295 – 296
  · Lines 306 – 307
• Line 908 – Consider making the Conformance ID column narrower since there is a lot of unused whitespace in the table

Thanks,
 
Mark
Mark Combellack| Software Developer| Avaya | Eastern Business Park | St. Mellons | Cardiff | CF3 5EA | Voice: +44 (0) 29 2081 7624 | mcombellack@avaya.com

---

From: David Booz [mailto:booz@us.ibm.com] 
Sent: 29 April 2009 16:21
To: sca-j@lists.oasis-open.org
Subject: Re: [sca-j] Java CI spec - up to date issues applied

Simon,

Thanks for the thorough review. I've made all the updates (and a few more that I spotted along the way) and published new documents. If anyone else has comments on WD08, no worries, I will fold them in on top of this new WD09 draft and produce another set of documents. If you haven't started reviewing yet, WD09 is as good a place to start as any.

http://www.oasis-open.org/committees/download.php/32313/sca-javaci-1.1-spec-wd09.doc
http://www.oasis-open.org/committees/download.php/32312/sca-javaci-1.1-spec-wd09.pdf


Dave Booz
STSM, BPM and SCA Architecture
Co-Chair OASIS SCA-Policy TC and SCA-J TC
"Distributed objects first, then world hunger"
Poughkeepsie, NY (845)-435-6093 or 8-295-6093
e-mail:booz@us.ibm.com

Simon Nash ---04/29/2009 05:22:04 AM---Dave, I have reviewed this and I have a number of editorial comments. I have

From:	Simon Nash <oasis@cjnash.com>
To:	sca-j@lists.oasis-open.org
Date:	04/29/2009 05:22 AM
Subject:	Re: [sca-j] Java CI spec - up to date issues applied

---

Dave,
I have reviewed this and I have a number of editorial comments.  I have
recorded these as inline Word comments in the attached .doc file.

  Simon

David Booz wrote:
> Here are the links to a current Java CI spec. We have never published a 
> CD of this spec, so please review it and all predecessors carefully as 
> this is the basis for CD01 and PRD. The sooner you can review and 
> provide comments, the sooner I can fold in the changes and re-publish.
> 
> http://www.oasis-open.org/committees/download.php/32270/sca-javaci-1.1-spec-wd08.doc
> 
> http://www.oasis-open.org/committees/download.php/32269/sca-javaci-1.1-spec-wd08.pdf
> 
> 
> Dave Booz
> STSM, BPM and SCA Architecture
> Co-Chair OASIS SCA-Policy TC and SCA-J TC
> "Distributed objects first, then world hunger"
> Poughkeepsie, NY (845)-435-6093 or 8-295-6093
> e-mail:booz@us.ibm.com
> 

[attachment "sca-javaci-1.1-spec-wd08+simon.doc" deleted by David Booz/Poughkeepsie/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