RE: [ws-rx] Groups - WSRM-CD4.zip uploaded

[Marc Goodner <mgoodner@microsoft.com>]

Pete, if Mary can do that it would make handling the comments a lot easier.

I thought we agree the formatting problems would be fixed before publication of the HTML on today's call. I certainly don't see those formatting issues as PR comments, especially as they only pertain to an alternative generated view of the spec. We should just get it fixed before it is published.

-----Original Message-----
From: Pete Wenzel [mailto:pete.wenzel@Sun.COM]
Sent: Thursday, August 17, 2006 2:31 PM
To: Paul Cotton
Cc: ws-rx@lists.oasis-open.org
Subject: Re: [ws-rx] Groups - WSRM-CD4.zip uploaded

Good comments, Paul.  In addition, the HTML rendition lacks line numbers; this makes it difficult to cite and locate text precisely.

I suggest that we ask Mary to include a notation like this in the PR
announcement:

  The HTML-formatted specifications are provided for informational
  purposes only; all comments should be made against the PDF versions,
  which are to be considered authoritative.

This has been done for at least one other TC that I remember.  (In that case, the HTML rendering was actually superior.)

--Pete

Thus spoke Paul Cotton (Paul.Cotton@microsoft.com) on Thu, Aug 17, 2006 at 01:44:37PM -0700:
> Initial comments on the RM HTML:
>
> a) Status section uses an unusually small font.  This is different than the PDF text.
> b) Standalone URLs and XML fragments use an unusally small font.  This is different than the PDF text.
> c) All the XML fragments I have reviewed have lost their indentation.  This includes the XML Schema and WSDL files in the Appendices.
> d) The Event and State Name example cells appear to have an extra blank line in them.
> e) All the Detail fragments I have reviewed have lost their background colour.  This is different than the PDF text.
>
> /paulc
>
> ________________________________________
> From: gilbert.pilz@bea.com
> Sent: August 17, 2006 3:59 PM
> To: ws-rx@lists.oasis-open.org
> Subject: [ws-rx] Groups - WSRM-CD4.zip uploaded
>
> The document revision named WSRM-CD4.zip has been submitted by Gilbert
> Pilz to the OASIS Web Services Reliable Exchange (WS-RX) TC document repository.
>  This document is revision #5 of WSRM-CD4.zip.
>
> Document Description:
> CD4 package of files
> RM spec, RMP spec, WSDL, XSD and diffs from CD3 Add HTML version;
> directory structured for deployment on doc.oasis-open.org
>
> View Document Details:
> http://www.oasis-open.org/apps/org/workgroup/ws-rx/document.php?docume
> nt_id=19802
>
> Download Document:
> http://www.oasis-open.org/apps/org/workgroup/ws-rx/download.php/19802/
> WSRM-CD4.zip
>
> Revision:
> This document is revision #5 of WSRM-CD4.zip.  The document details
> page referenced above will show the complete revision history.
>
>
> PLEASE NOTE:  If the above links do not work for you, your email
> application may be breaking the link into two pieces.  You may be able
> to copy and paste the entire link address into the address field of your web browser.
>
> -OASIS Open Administration

--
Pete Wenzel <pete.wenzel@sun.com>
Sun Microsystems, SOA & Business Integration Standards & Product Strategy
+1 (626)471-6311, Sun x61311, US-Pacific TZ