Turned the catch-all issue box into several local boxes. Made another patch to ReSpec to make custom markup in the references section easier.
--- a/ReSpec.js/js/respec.js Thu May 26 12:47:48 2011 +0100
+++ b/ReSpec.js/js/respec.js Fri May 27 11:00:49 2011 +0100
@@ -1282,12 +1282,19 @@
}
for (var i = 0; i < del.length; i++) delete informs[del[i]];
+ var tmp = document.getElementById("references");
+ if (tmp) {
+ tmp.parentNode.removeChild(tmp);
+ }
var refsec = sn.element("section", { id: "references", "class": "appendix" }, document.body);
sn.element("h2", {}, refsec, "References");
if (this.refNote) {
var refnote = sn.element("p", {}, refsec);
refnote.innerHTML= this.refNote;
}
+ if (tmp) {
+ sn.copyChildren(tmp, refsec);
+ }
var types = ["Normative", "Informative"];
for (var i = 0; i < types.length; i++) {
--- a/index.html Thu May 26 12:47:48 2011 +0100
+++ b/index.html Fri May 27 11:00:49 2011 +0100
@@ -138,6 +138,13 @@
<section id="section-Introduction">
<h2>Introduction</h2>
+ <p class="issue">This document reflects current progress of the RDF Working
+ Group towards updating the
+ <a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/">2004
+ version of <em>RDF Concepts and Abstract Syntax</em></a>. The
+ editors expect to work on a number of issues, some of which are
+ listed in boxes like this throughout the document.</p>
+
<p>The Resource Description Framework (RDF) is a framework for
representing information in the Web.</p>
@@ -160,6 +167,11 @@
<li>this document, (sections 4, 5, 6 and 7).</li>
</ul>
+ <p class="issue">This document was written when RDF/XML was the
+ only normative syntax. Now it is just one of many syntaxes and
+ it should be de-emphasized accordingly. There is no reason why
+ it should be a normative reference in this document.</p>
+
<p>Within this document, normative sections are explicitly labelled as such.
Explicit notes are informative.</p>
@@ -172,34 +184,14 @@
Others (cf. OWL [[OWL-REF]] and
the applications mentioned in the primer
[[RDF-PRIMER]]) are in development.</p>
-
- <div class="issue">
- <p>This document reflects current progress of the RDF Working
- Group towards updating the
- <a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210/">2004
- version of <em>RDF Concepts and Abstract Syntax</em></a>. The
- editors expect to work on a number of issues, some of which are
- listed below, and more are listed in boxes like this throughout
- the document.</p>
- <ul>
- <li>Too strongly coupled with RDF/XML; it's now just one out of many syntaxes and should perhaps not even be a normative reference</li>
- <li>Move some content between RDF Semantics, RDF Schema and this document</li>
- <li>Revisit informative sections 2 and 3; do they add value? Section 3 is very redundant with later normative sections</li>
- <li>RFC 3066 is obsoleted by BCP47</li>
- <li>RFC 2279 is obsoleted by RFC 3629</li>
- <li>RFC 2396 is obsoleted by RFC 3986</li>
- <li>Change OWL reference to OWL2?</li>
- <li>Change XHTML10 reference to XHTML5?</li>
- <li>Should discuss rdf:PlainLiteral</li>
- </ul>
- </div>
-
</section>
<section id="section-Overview">
<h2>Motivations and Goals</h2>
+ <p class="issue">Does this section add value?</p>
+
<p>RDF has an abstract syntax that reflects a simple graph-based
data model, and formal semantics with a rigorously defined notion
of entailment providing a basis for well founded deductions in RDF
@@ -336,6 +328,8 @@
<section id="section-Concepts">
<h2>RDF Concepts</h2>
+ <p class="issue">This section is quite redundant with later normative sections and the RDF Primer.</p>
+
<p>RDF uses the following key concepts:</p>
<ul>
@@ -727,6 +721,10 @@
<section name="section-Datatypes">
<h2>Datatypes (Normative)</h2>
+ <p class="issue">This section perhaps should discuss
+ <a href="http://www.w3.org/TR/rdf-mt/#dtype_interp">the XSD datatype map</a>
+ and <code><a href="http://www.w3.org/TR/rdf-plain-literal/">rdf:PlainLiteral</a></code>.</p>
+
<p>
The datatype abstraction used in RDF is compatible with
the abstraction used in
@@ -930,6 +928,9 @@
hence be optimized.
</p>
+ <p class="issue">The SPARQL WG proposed to add definitions for
+ “RDF Term” and “Simple Literal”.</p>
+
<section id="section-triples">
<h3>RDF Triples</h3>
@@ -1567,6 +1568,19 @@
</ul>
</section>
+
+<section id="references">
+ <div class="issue">
+ <ul>
+ <li>RFC 3066 is obsoleted by BCP47</li>
+ <li>RFC 2279 is obsoleted by RFC 3629</li>
+ <li>RFC 2396 is obsoleted by RFC 3986</li>
+ <li>Change OWL reference to OWL2?</li>
+ <li>Change XHTML10 reference to XHTML5?</li>
+ </ul>
+ </div>
+</section>
+
</body>
</html>