OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

wsdm message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [wsdm] Groups - WSDM Primer: An introduction to WSDM (wd-wsdm-primer-introduction_v1.doc) modified


In reading over section 1.1, I think the whole section should be
whacked--don't waste time trying to rewrite it.  It should be
transferred to an "Introduction" of the Primer itself.  The standalone
document should start off with the Overview of WSDM section--IMO.

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

-----Original Message-----
From: Vaughn Bullard [mailto:vbullard@amberpoint.com] 
Sent: Wednesday, September 07, 2005 9:52 AM
To: Wilson, Kirk D; wsdm@lists.oasis-open.org
Subject: RE: [wsdm] Groups - WSDM Primer: An introduction to WSDM
(wd-wsdm-primer-introduction_v1.doc) modified

Hey Kirk,

No problemo Senor.  Heather had stated that it would be a good idea to
all the editors under the editor heading.  Yesterday I had the entire
revision history in there but was deciding if this was a new document,
it should probably have a new revision history.  Exclusion was not the
concept there.

My other comments are listed below:


-----Original Message-----
From: Wilson, Kirk D [mailto:Kirk.Wilson@ca.com] 
Sent: Wednesday, September 07, 2005 8:10 AM
To: vbullard@amberpoint.com; wsdm@lists.oasis-open.org
Subject: RE: [wsdm] Groups - WSDM Primer: An introduction to WSDM
(wd-wsdm-primer-introduction_v1.doc) modified

Just some general comments on an initial scan of the document.

1.  The double colons in the title look strange (IMHO).  I would suggest
dropping the first colon between Management and Primer.  Or better yet,
drop "Primer:" (see point 3).

>>	Ahh, no problemo on this one.  I thought so to.  Will fix.

2.  Since I basically wrote the first chapter (weaknesses, mistakes and
for which I take full responsibility), would it be appropriate that I
be listing as an "editor"?  (I realize that usually the specification
only the editor rather than the authors, but this single chapter may
count as an exception.  Otherwise, please clean up the revision history
be more explicit about this history of this particular volume.)

>>	I am going to put the editors in there.  Providing this gives
insight into the mind of the crafters of this doc.  I'm just editing it.
Don't feel at all bad about me correcting grammar, >>	mistakes, etc.
That's what editing is all about.  This is a group effort.  It's always
better to have more than one head working on the same problem.  And
I'm a German 
>>	Engineer!!!

3.  I think there's a question we need to decide regarding section 1.1
(Overview of the Primer).  If this stand-alone document is to be read as
separate document introducing the fundamentals of WSDM, then this
probably needs to be cleaned up, e.g., statement such as "Examples are
developed throughout this primer..." need to be abstracted into just a
statement about the structure of WSDM.  If this introduction is to be
published as part of the Primer, then leaving section 1.1 as it stands
sense.  How are we presenting this document?  (I thought it was to be a
handout at the EMW, in which case I would drop "Primer:"
from the title and rewrite some of section 1.1.  Also, I would probably
refer to "this primer" in the text of this document.)  How are we
the Primer?  (As one volume or multiple volumes?  How will the
section be published with a multi-volume primer?  If we keep it as a
standalone document, the some of section 1.1 as it currently standards
should be part of a very short introductory section the current Primer.)
Also, the final paragraph that is currently in this draft should be
from a standalone document, but included in a short introduction to the
primer itself.

>>	I saw the "examples are developed" phrase and was going to fix
Apologize but it got toward 11 pm last night and I was just slightly


4.  The first subsection under section should be 2.1, not 2.1.1?

>>	Will Fix

5. Since section 1 of the full Primer is still undergoing revisions, we
a problem in keeping this standalone document in sync with the "master".
For example, changes are under consideration for the discussion on the
Agnostic section (section, which should be 2.1.4).

>>	I too, was wondering do we keep it as a separate doc.  What will
the maintenance implications of this?

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

-----Original Message-----
From: vbullard@amberpoint.com [mailto:vbullard@amberpoint.com]
Sent: Tuesday, September 06, 2005 10:30 PM
To: wsdm@lists.oasis-open.org
Subject: [wsdm] Groups - WSDM Primer: An introduction to WSDM
(wd-wsdm-primer-introduction_v1.doc) modified

Information about the document named WSDM Primer: An introduction to
(wd-wsdm-primer-introduction_v1.doc) has been modified by Mr. Vaughn

Document Description:

View Document Details:

Download Document:  

PLEASE NOTE:  If the above links do not work for you, your email
may be breaking the link into two pieces.  You may be able to copy and
the entire link address into the address field of your web browser.

-OASIS Open Administration

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]