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

[Pete Wenzel <pete.wenzel@Sun.COM>]

Gil, I wasn't implying that line numbers should be added to the HTML
docs.  Clearly that wouldn't make sense, nor would it be worth wasting
your (editors') valuable time on, even if feasible.  Just noting that
the HTML docs are less convenient than the PDF docs in this regard,
especially for review periods, and we shouldn't pretend that the two
formats are equivalent.  I like Marc's idea of annotating the HTML
doc to indicate it is not the preferred rendition.

--Pete

Thus spoke Gilbert Pilz (Gilbert.Pilz@bea.com) on Thu, Aug 17, 2006 at 03:57:56PM -0700:
> 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