Re: [sca-assembly] CD 03 zip file uploaded - Now ready to Submitfor Publication and Public Review

[Anish Karmarkar <Anish.Karmarkar@oracle.com>]

Mike Edwards wrote:
> 
> Folks,
> 
> First, many thanks to Anish for getting this done.
> 
> The PDF needs regenerating - I will ask Dave Booz to do this, but there 
> are a number of formatting
> errors in there (not in the Word or the HTML), plus the lack of live links.
> 
> I'd like to ask about the RDDL - is it easy to get the RDDL updated as 
> and when the new XSDs
> get approved?

I think it would be very easy to update the RDDL. I would be happy to 
volunteer for this.

> 
> Unless someone screams, I intend to submit this package for publication 
> later today and to formally
> request the start of the public review, with the only change being an 
> updated clean version of
> the PDF.

Based on the feedback I got, I have updated the zip file (as well as the 
  PDF and doc version) "in place" in our doc repository.

The zip file has been updated for the following:
1) There are now two RDDL files (one based on Bryan's and one based on CD01)
2) I did fix the RDDL files to make them consistent wrt order of schema 
files and made a few fixes in Bryan's version. I also fixed a bug in the 
description of intent definitions. Previously it was called out to be a 
schema, which it is obviously not. I have also included the C/C++ 
artifacts in the RDDLs in anticipation of their approval by C/C++ TC 
tomorrow.
3) I changed the front page of the CD03 (doc, pdf and html) to have the 
'previous version' point to the CD02 docs in our repository (the public 
links). These do not point to docs.oasis-open.org but instead point to 
www.oasis-open.org. In doing so, the 'previous version' only has links 
to .doc and .pdf. CD02 HTML version does not exist and I didn't think it 
was worth the effort to create a subdirectory with all the figures that 
would be required for HTML.
4) I have *not* changed the diff version (doc, pdf, html) to reflect the 
front page change. I didn't think it was worth the effort.
5) This means that if we want the PDF to contain the right TOC links, 
Dave will have to oblige us and regen the PDF again. Sorry Dave!

-Anish
--

> 
> 
> 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: 	Anish Karmarkar <Anish.Karmarkar@oracle.com>
> To: 	OASIS Assembly <sca-assembly@lists.oasis-open.org>
> Date: 	18/03/2009 07:35
> Subject: 	[sca-assembly] CD 03 zip file uploaded
> 
> 
> ------------------------------------------------------------------------
> 
> 
> 
> Located at:
> http://www.oasis-open.org/apps/org/workgroup/sca-assembly/download.php/31728/sca-assembly-1.1-spec-cd03.zip
> 
> It contains CD03 doc/pdf/html (no diff-marks), CD03 doc/pdf/html (diff
> with cd02), all the schemas, intent definitions, and RDDL.
> 
> Please note the following:
> 
> 1) The spec is based on the old cd03 (cd02-rev8) and was changed per the
> CD03 approval motion.
> 
> 2) The schemas were based on the ones that MikeE sent out [1], but
> modified per the CD03 approval motion.
> 
> 3) The RDDL was based on [2] and not on the one sent out by Bryan [3].
> Mary had made changes when we published CD01, those changes were not
> reflected in Bryan's version.
> 
> 4) The RDDL currently does not contain pointers to schemas from TCs that
> have not approved a CD with the new NS. I assume as other TCs approve
> their specs the RDDL will get updated.
> 
> 5) The HTML version is straight from MS word. I have not attempted to
> Tidy it up or clean up the Word round-tripping markup. If someone wants
> to do that, please do so and update the zip file.
> 
> 6) The PDFs do not contain links for TOCs. Dave has the magic wand to
> produce PDFs that have that.
> 
> 7) My version of word shows some strange things wrt the tags (ASMXXXXX)
> and the highlighting. The "strange things" is only wrt
> change-mark/yellow color (not content). I *think* I 'fixed' all of it,
> but pl. check.
> 
> 8) We did not publish CD02. I included CD02 as previous version on the
> front page of the spec. Do we need to change it to CD01?
> 
> 9) The way the schemas are hosted on docs.oasis-open.org, they are all
> in the same directory and not in the dated (200903/200712) directory.
> This is an issue with OASIS, and goes against the decision that the TC
> made. This may cause broken links (like it did in CD01). We need to get
> this fixed.
> 
> If you see any errors please send it to the list.
> 
> -Anish
> --
> 
> [1] http://lists.oasis-open.org/archives/sca-assembly/200903/msg00077.html
> [2] http://docs.oasis-open.org/opencsa/sca-assembly/scanamespace.html
> [3] http://lists.oasis-open.org/archives/sca-assembly/200903/msg00111.html
> 
> 
> ---------------------------------------------------------------------
> 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/
> 
> 
> 
> 
> 
>