Best Practices doc review

Ahead of today's meeting I've read through the document as it was at 
11:00 GMT.

One thing that struck me as a native speaker was that the language 
needed a but of polish here and there (this is not a criticism!) and 
looking in more detail at some aspects there were one or two W3C-style 
things that needed fixing too. So rather than give Ghis, Boris and 
Bernadette a long list  I've made the changes directly.

Main changes:
- all target="_blank" attributes removed from hyperlinks;
- removed conformance boilerplate and made all references informative - 
this is a Note, not a Rec so nothing is normative;
- all shortened URIs replaced by target URI;
- simplified English spelling to US-style throughout;
- replaced data set with dataset throughout (I have no strong view but a 
quick survey on Twitter today suggests that the preference is to spell 
it without a space);
- generally tidied up a few awkward bits of sentence construction.

There are a few (I think 3) instances of <del>...</del>. These indicate 
my preference/view rather than a policy or English language norm - i.e. 
WG consensus is needed to make the changes (I can talk about them on the 
call later).

I do not claim that the doc is now error free, but the number of typos 
etc should be less than it was.

HTH

Phil.

-- 


Phil Archer
W3C Data Activity Lead
http://www.w3.org/2013/data/

http://philarcher.org
+44 (0)7887 767755
@philarcher1

Received on Thursday, 12 December 2013 13:34:28 UTC