Re: Review of 19 August Editor's Draft of SKOS Primer

Hi Tom, Ralph, Guus,

I have put a new editor's draft, dated 20 August, on the wiki [1].
It includes Tom's edits, Ed's new example (removing one platypus bit) 
and should address Tom's comment of [2] including a solution for notes 
and table.

Cheers,

Antoine

[1] 
http://www.w3.org/2006/07/SWD/wiki/SKOS/DraftPrimer?action=AttachFile&do=get&target=SKOSPrimer-080820.html
[2] http://lists.w3.org/Archives/Public/public-swd-wg/2008Aug/0048.html

>
> Hi Tom,
>
>> 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.
>>   
>
>
> Thank you very much for this highly valueable review! Your mail does 
> not show it, but the list of edits you've sent is impressive, and it 
> enhances readability a lot.
>
>> 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.
>>   
>
> I also don't like this apostrophe as well. Plus we're using URIs and 
> not URI's...
> Actually we could be saved by the W3C manual of style:
> http://www.w3.org/2001/06/manual/#ref-PLURAL which cites 
> http://xml.coverpages.org/properSpellingForPluralOfDTD.html , itself 
> rather against the use of apostrophe ;-)
>
> For the moment I'm gonna keep KOS's but that's just waiting for others 
> to confirm my understanding of the above references.
>
>> -- 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".
>>   
>
> Does it work the same with "kinds"? There are situation for which I 
> have serious doubts (e.g. "kinds of hierarchical relation")
>
>> A few other comments:
>>
>> -- Section 2.2 refers to "Terms used as descriptors", italicizing
>>    "descriptors".  It would be nice to add a reference here.
>>   
>
> I added a reference to Willpower Glossary.
>
>> -- 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?
>>   
>
> I'd like Guus'advice on that, as he may knows more than us the 
> accessibility rules we could break if opting for smaller font.
> Also, he was instrumental in having us create these specific notes. 
> Meanwhile I'll investigate if I can change the page's style. But I'm 
> not an HTML expert...
>
>> -- 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.
>>   
>
> We'll try to solve that.
>
>> -- "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]
>>>     
>>
>>   
> I'll be putting on the wiki a new version in a couple of hours, if 
> Ralph and Guus want to have a look.
> But yes, your review heps a lot!
>
> Cheers,
>
> Antoine
>
>
>

Received on Wednesday, 20 August 2008 13:35:43 UTC