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

[Marc Goodner <mgoodner@microsoft.com>]

I think the point is to add the text to the html version suggesting it is a convenience, and that readers use the pdf version with line numbers to file comments.

-----Original Message-----
From: Gilbert Pilz [mailto:Gilbert.Pilz@bea.com]
Sent: Thursday, August 17, 2006 3:58 PM
To: Pete Wenzel; Paul Cotton
Cc: ws-rx@lists.oasis-open.org
Subject: RE: [ws-rx] Groups - WSRM-CD4.zip uploaded

I'm having trouble understanding what use line numbers would be in a format that allows you to change the text flow when you re-size your browser window. For example, take a look at this very nice looking spec:
http://www.w3.org/TR/2006/REC-ws-addr-core-20060509/. No line numbers.

- gp

> -----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
>