RE: [wsdm] Groups - Primer with Heather's updates forMetadataand Extending capabilities (wd-wsdm

["Wilson, Kirk D" <Kirk.Wilson@ca.com>]

I have no objection to "primer" for the master document.  In fact, my
apologies, I think I got my threads confused while trying to multi-task.
I really meant my comment to be directed to Vaughn and what he is
working on.

The standalone document that Vaughn is working would not fall under the
category of a primer--it is an introduction to a primer that is being
extracted into a stand alone document.  (I have recommended to Vaughn
that we drop the whole first section, and thus the title "Introduction"
for the section would disappear--thus resolving the ambiguity.)


Kirk Wilson
Architect, Development
Office of the CTO
802 765-4337
 

-----Original Message-----
From: Mark Peel [mailto:mpeel@novell.com] 
Sent: Wednesday, September 07, 2005 3:07 PM
To: Wilson, Kirk D; wsdm@lists.oasis-open.org
Subject: RE: [wsdm] Groups - Primer with Heather's updates
forMetadataand Extending capabilities (wd-wsdm


  I don't understand your objection to "primer", Kirk.  American
Heritage defines a primer as "a book that covers the basic elements of a
subject"; I don't see any implication that a primer is not standalone *
the contrary, really.  But I have no objection to using "document" in
the place of "primer" in the sentence: we certainly aren't producing a
book, after all...

  "This introduction" is ambiguous: the sentence occurs in the section
titled "Introduction".

Cheers,


Mark Peel
Web Services Infrastructure
Novell, Inc.

>>> "Wilson, Kirk D" <Kirk.Wilson@ca.com> 9/7/2005 1:52:20 pm >>>
If this is truly a standalone document, then we should not refer to
"this primer".  What primer?  Where is it (in relation to the document
they are reading)?  Perhaps refer to "this document" or "this
introduction".

Kirk Wilson
Architect, Development
Office of the CTO
802 765-4337
 

-----Original Message-----
From: Mark Peel [mailto:mpeel@novell.com] 
Sent: Wednesday, September 07, 2005 12:49 PM
To: Wilson, Kirk D; wsdm@lists.oasis-open.org 
Subject: RE: [wsdm] Groups - Primer with Heather's updates for
Metadataand Extending capabilities (wd-wsdm


  We might begin to address Kirk's point by recasting the first
sentence of the introduction:

"Reading this primer should prepare the reader to understand the
specifications that make up the WSDM standard (Management of Web
Services and Management Using Web Services; abbreviated MOWS and MUWS)
and also some of that standard's supporting specifications (e.g.,
WS-ResourceProperties and WS-BaseNotification)."

Cheers,


Mark Peel
Web Services Infrastructure
Novell, Inc.

>>> "Wilson, Kirk D" <Kirk.Wilson@ca.com> 9/7/2005 9:39:00 am >>>
Heather, Bryan,

Question on some changes in section 1.  I noticed in this version, a
number of occurrences of "WSDM" in the Primer Introduction were
changed
to the more technically correct "MUWS" or "MOWS".  However, for the
reader, the distinction between MUWS and MOWS is not introduced until
section 1.2.4.2.  Doesn't the change assume that the reader is already
going to be familiar with the organization of the specification before
reading the introduction?




---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  You may a link to this group and all your TCs in
OASIS
at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php