Writing BPs, ISSUE-106

Dear all,

I have just made another couple of additions to the BP doc which are 
currently BPs 3 & 4. These, I hope, answer Issue-106 so I have closed 
that one.

If, as we plan, this is to become a Recommendation then we will need to 
gather proof that multiple people have implemented each of the best 
practices - which is a tough task but that's what we're committed to.

In order to be able to do that we need to be very clear on what is 
normative and what is informative. This is why in the BPs I've written I 
have included an RFC 2119 keyword (MUST, SHOULD or MAY) in the *Intended 
Outcome* section.

Can other please do this?

You can make the keywords explicit thus:

<em class="rfc2119">must</em>

(the stylesheet will capitalise and colour the word)


HTH

Phil.


-- 


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

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

Received on Monday, 12 January 2015 12:37:05 UTC