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

["Gilbert Pilz" <Gilbert.Pilz@bea.com>]

I think noting that the HTML version is provided as a convenience is a
good idea. Do you think such a notice belongs in the document itself or
perhaps in the RDDL document?

- gp

> -----Original Message-----
> From: Marc Goodner [mailto:mgoodner@microsoft.com] 
> Sent: Thursday, August 17, 2006 4:02 PM
> To: Gilbert Pilz; Pete Wenzel; Paul Cotton
> Cc: ws-rx@lists.oasis-open.org
> Subject: RE: [ws-rx] Groups - WSRM-CD4.zip uploaded
> 
> 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
> >
>