Review of 19 August Editor's Draft of SKOS Primer

Review of 19 August Editor's Draft of SKOS Primer

Summary:

I have sent to Antoine and Ed alot of comments on minor points
of detail in the form of edits to the draft I reviewed.
Content-wise, the text fits my understanding of the SKOS
data model, or at any rate I did not catch any errors.
The text reads very nicely - congratulations to the editors!
I recommend publication.

Details:

Most of my edits had to do with typos, misspellings, awkward
phrasings and the like.  Only two general issues seem important
enough to mention here:

-- The plural of "KOS".  The draft used "KOSs" or just
   "KOS", as in "many existing KOS".  The Chicago Manual of
   Style recommends "KOS's".  "KOSes" would be possible. I have
   normalized everything to "KOS's" for now, though I don't
   really like the way it looks.  If the KOS community has an
   established way to pluralize KOS, I suggest we follow that.

-- The construct "various types of".  Guus
   suggests "various types of notes" (plural), so I have
   normalized to that -- including the change: "other types
   of KOS's".

A few other comments:

-- Section 2.2 refers to "Terms used as descriptors", italicizing
   "descriptors".  It would be nice to add a reference here.

-- As they are currently formatted, the "Notes" interspersed
   in the text do not look quite right -- especially because
   quoted codings are indented less than the surrounding text.
   Could the notes perhaps be formatted in line with the rest
   of the text but in a smaller font?

-- The table comparing ISO 2788/5964 with SKOS is really nice,
   though I would recommend that the left column be "flush
   top" within the cell.  I also note that long cell texts that
   span two pages get vertically centered on the second page.

-- "Messing with the SKOS vocabulary" is "tough" language --
   but I rather like it :-)

I am happy for this to be considered a review in fulfillment
of:

> ACTION: Ralph and Guus to review
> the Primer Editor's Draft [recorded in
> http://www.w3.org/2008/08/19-swd-minutes.html#action06]

-- 
Tom Baker - tbaker@tbaker.de - baker@sub.uni-goettingen.de

Received on Wednesday, 20 August 2008 11:09:53 UTC