Re: responses to public review comments, CPA-CPP 0.93

[Martin W Sachs <mwsachs@us.ibm.com>]

Tim,

There were no technical substantive issues in the last QR iteration.  The
QR comments were  a large collection of small formatting and related
details that have been mostly incorporated and are too small and numerous
for a formal response.  FYI, here are the QR comments that I ignored and
why.

Use of pseudo-XML examples:  the comment appears to be asking for a full
CPP or CPA example everywhere we have a fragment to illustrate a particular
element.  That's impractical, to say the least. Use of such fragments as
illustrations is standard practice in XML literature. Appendices A and B
have full examples.  In the earlier round, QR was asking that the fragments
be validated by a parser.  That's impossible since they aren't proper
instance documents and aren't intended to be.

Don't use SHOULD in a non-normative note:  Someone hasn't read RFC 2119.
SHOULD is advisory, not prescriptive, and is appropriate in non-normative
text.

Complaint that the header says "20 March 2001", not "March 2001":  Word
does not provide "March 2001" as an option for automatic dating.  Use of
automatic dating is important for obvious reasons.  Similar comment about
use of the time in the date just below the title:  Inclusion of the time
(automatically supplied) is important for tracking of successive drafts.

Complaint that in the table of contents, the titles for sections 10 and 11
don't line up with the earlier titles:  Of course not.  Word maintains the
same space between section number and text regardless of the number of
digits in the section number.  (Actually, the space seems a bit too wide
for sections 10 and 11 but that's a Word bug.)

Put space before [ throughout.  That is absolutely wrong:  There should
never be a space between a word and its reference callout.  That would
cause some of the reference callouts to be on the following line where the
reader may miss them.  This has been standard practice in technical and
scholarly writing for at least as long as I have been alive.  The cases
where there is a space before [ is where the reference callout is being
used as a shorthand for the full title, as in [SSL].

Extra space between some letters of some titles:  This is a Word rounding
error in its letter placement algorithm.

Line 918:  The QR comments appears to be calling for a full XMLDSIG element
example.  We specifically refer to XMLDSIG for details.  Adding the full
example would be error prone and not helpful to the reader.

Regards,
Marty

*************************************************************************************

Martin W. Sachs
IBM T. J. Watson Research Center
P. O. B. 704
Yorktown Hts, NY 10598
914-784-7287;  IBM tie line 863-7287
Notes address:  Martin W Sachs/Watson/IBM
Internet address:  mwsachs @ us.ibm.com
*************************************************************************************



"Tim McGrath" <tmcgrath@tedis.com.au> on 04/16/2001 09:08:15 PM

Please respond to tmcgrath@tedis.com.au

To:   Martin W Sachs/Watson/IBM@IBMUS
cc:   ebxml-tp@lists.ebxml.org, najmi@sun.east.com,
      pyendluri@webmethods.com, Scott Hinkelman/Austin/IBM@IBMUS,
      duane@xmlglobal.com
Subject:  Re: responses to public review comments, CPA-CPP 0.93



many thanks for this update, you are obviously keeping busy.

i have a few comments:

1. are the comments from QR addressed elsewhere?
and
2. i presume you are intending to publish a revised specification for
review prior to
vienna (minimum of 1 week) - we will make a public comment on any remaining
issues at
that time.  i don't expect this to be more than a formality to ensure all
comments have
been disposed of appropriately.

Martin W Sachs wrote:

> Here are the TP team's responses to the public-review comments on CPA-CPP
> ver. 0.93.
>
> Regards,
> Marty
>
> (See attached file: Pub.Rev.TP.0.93.changes.pdf)
>
>
*************************************************************************************

>
> Martin W. Sachs
> IBM T. J. Watson Research Center
> P. O. B. 704
> Yorktown Hts, NY 10598
> 914-784-7287;  IBM tie line 863-7287
> Notes address:  Martin W Sachs/Watson/IBM
> Internet address:  mwsachs @ us.ibm.com
>
*************************************************************************************

>
>
------------------------------------------------------------------------
>                                   Name: Pub.Rev.TP.0.93.changes.pdf
>    Pub.Rev.TP.0.93.changes.pdf    Type: Portable Document Format
(application/pdf)
>                               Encoding: BASE64

--
regards
tim mcgrath
TEDIS   fremantle  western australia 6160
phone: +618 93352228  fax: +618 93352142