W3C home > Mailing lists > Public > public-rdf-wg@w3.org > May 2012

Re: Subsection 11.2 - Displaying (X)HTML

From: Richard Cyganiak <richard@cyganiak.de>
Date: Thu, 17 May 2012 19:40:08 +0100
Cc: Dominik Tomaszuk <ddooss@wp.pl>, RDF Working Group WG <public-rdf-wg@w3.org>
Message-Id: <DFD59C18-B293-43C9-8061-69EDFBD6CEAC@cyganiak.de>
To: Gavin Carothers <gavin@topquadrant.com>

[moving this over to RDF-WG list]

On 17 May 2012, at 17:48, Gavin Carothers wrote:
> All of the Turtle in HTML section is non-normative.

Is it?

It's currently impossible to tell what's normative and what's informative in the Turtle ED.

Some sections are titled “X.Y Section Title (Informative)”.

Some sections are titled “X.Y Section Title (Normative)”.

Some sections are just titled “X.Y Section Title”.

Some sections start with the phrase “This section is non-normative”. The presence of this phrase seems not to be correlated with the presence of “(Informative)” in the section title.

W3C's QA Framework [1] states as a Good Practice: “Specify in the conformance clause how to distinguish normative from informative content.” In fact, ReSpec automatically includes a boilerplate sentence defining this when you include a section like so:

   <section id="conformance">
       (… additional body content for Conformance section here …)

This also inserts boilerplate explaining the RFC2119 magic words (MUST, SHOULD, etc.) and a reference to the RFC. This is currently also missing from the Turtle ED.

See [2] for an example of this ReSpec feature in action.


[1] http://www.w3.org/TR/qaframe-spec/
[2] http://dvcs.w3.org/hg/rdf/raw-file/default/rdf-concepts/index.html#conformance
Received on Thursday, 17 May 2012 18:40:42 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 17:04:17 UTC