- From: Antoine Isaac <aisaac@few.vu.nl>
- Date: Wed, 20 Aug 2008 15:34:53 +0200
- To: Thomas Baker <baker@sub.uni-goettingen.de>
- CC: SWD Working Group <public-swd-wg@w3.org>
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