[poe] Systematic labeling of normative vs. informative

iherman has just created a new issue for https://github.com/w3c/poe:

== 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).

Please view or discuss this issue at https://github.com/w3c/poe/issues/155 using your GitHub account

Received on Friday, 28 April 2017 08:01:35 UTC