- From: Renato Iannella via GitHub <sysbot+gh@w3.org>
- Date: Sat, 29 Apr 2017 13:19:24 +0000
- To: public-poe-archives@w3.org
riannella has just labeled an issue for https://github.com/w3c/poe as "Vocab": == Systematic labeling of normative vs. informative == At the moment there is no separation between normative and informative sections. Remember that, in a W3C Rec, any section that is not explicitly labeled is considered to be normative. I think we will have to make a thorough overview on this. E.g. 1. We have to make explicit that examples are _not_ normative (e.g. in the conformance section) 2. I am not sure whether the XML serialization is normative or not. If it is, we will have to have test cases and implementations. (This is also related to issue #151) 3. I am not sure whether all terms defined in the vocab documents are normative or not. I seem to remember that we had some discussions on this in the past, and many (most?) terms in the vocab document are actually informative. There are probably more sections like that. Also, the choice whether a reference is normative or not depends on this. E.g., if we decide that the JSON-LD serialization is normative (I am not sure) then the corresponding json-ld reference must be normative (it is informative right now). See https://github.com/w3c/poe/issues/155
Received on Saturday, 29 April 2017 13:19:30 UTC