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:]
> Sent: Thursday, August 17, 2006 4:02 PM
> To: Gilbert Pilz; Pete Wenzel; Paul Cotton
> Cc:
> 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:]
> Sent: Thursday, August 17, 2006 3:58 PM
> To: Pete Wenzel; Paul Cotton
> Cc:
> 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:]
> > Sent: Thursday, August 17, 2006 2:31 PM
> > To: Paul Cotton
> > Cc:
> > 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 () 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:
> > > Sent: August 17, 2006 3:59 PM
> > > To:
> > > 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 <>
> > Sun Microsystems, SOA & Business Integration Standards & Product
> > Strategy
> > +1 (626)471-6311, Sun x61311, US-Pacific TZ
> >
>
