Turned the catch-all issue box into several local boxes. Made another patch to ReSpec to make custom markup in the references section easier.
authorRichard Cyganiak <richard@cyganiak.de>
Fri, 27 May 2011 11:00:49 +0100
changeset 20 cc3fb1e4ac5d
parent 17 aa4f57dc2b90
child 21 987b2047c1fc
Turned the catch-all issue box into several local boxes. Made another patch to ReSpec to make custom markup in the references section easier.
ReSpec.js/js/respec.js
index.html
--- 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>