--- a/rdf-primer/index.html Wed Nov 13 14:50:14 2013 +0100
+++ b/rdf-primer/index.html Wed Nov 13 14:58:29 2013 +0100
@@ -189,8 +189,8 @@
<p>The following illustrates various different uses of RDF, aimed
at different communities of practice.</p>
- <div class="issue">Should we add pointers to specific applications
- or use-case documents?</div>
+// <div class="issue">Should we add pointers to specific applications
+// or use-case documents?</div> NO
<ul>
<li>Adding machine-readable information to web pages using for example
@@ -225,8 +225,8 @@
<h2>RDF Data Model</h2>
- <p class="issue">Suggest not to discuss generalized RDF in the
- Primer</p>
+// <p class="issue">Suggest not to discuss generalized RDF in the
+// Primer</p> OK
<section id="subsection-triple">
@@ -272,13 +272,13 @@
</figure>
- <div class="issue">The following is just one way of representing
- RDF in relational terms, not sure it is needed</div>
-
- <div class="note">Readers familiar with databases could view the RDF
- data model as a binary database model, where every distinct
- predicate forms a two-column table with subjects in the first
- column and objects in the second column. </div>
+// <div class="issue">The following is just one way of representing
+// RDF in relational terms, not sure it is needed</div> REMOVED
+//
+// <div class="note">Readers familiar with databases could view the RDF
+// data model as a binary database model, where every distinct
+// predicate forms a two-column table with subjects in the first
+// column and objects in the second column. </div>
<p>In the following sections we discuss the three basic constructs
@@ -345,8 +345,8 @@
of datatypes</a>. This includes many datatypes defined by XML
Schema, such as string, boolean, integer, decimal and date. </p>
- <p class="issue">Suggest there is no need to mention the HTML and
- XMLLiteral datatypes in the Primer</p>
+// <p class="issue">Suggest there is no need to mention the HTML and
+// XMLLiteral datatypes in the Primer</p> OK
<p class="note">The 2004 version of RDF contained the notion of a
"plain literal" with no datatype. This feature has been removed as the
@@ -373,14 +373,10 @@
to denote resources without explicitly naming them with an
IRI.</p>
- <p class="issue">"survive" might be a bit strong - maybe another
- wording?</p>
-
<p class="note">Blank nodes can make RDF look very complicated,
especially when one consults details about blank nodes in the RDF Concepts
[[RDF11-CONCEPTS]] and RDF Semantics [[RDF11-MT]] documents. It
- should be noted that many RDF users survive without ever having
- to deal with blank nodes. </p>
+ should be noted that many RDF users in practice don't use blank nodes. </p>
</section>
@@ -391,8 +387,8 @@
<p>RDF provides a mechanism to group RDF statements in multiple
graphs and associate each graph with an IRI.<p>
- <p class="issue">Suggest to ignore here the fact that in principle
- a blank node can also be associated with a graph.</p>
+// <p class="issue">Suggest to ignore here the fact that in principle
+// a blank node can also be associated with a graph.</p> OK
<p>For example, the
statements in <a href="#subsection-triple">the first example</a> could be grouped in two
@@ -455,24 +451,26 @@
<h2>RDF Vocabularies</h2>
- <p class="issue">Not entirely sure about the VIAF example below - does it
- belong to a section on vocabularies? Wouldn't it be better to add
- an example of 'following your nose' to a vocabulary?</p>
+// <p class="issue">Not entirely sure about the VIAF example below - does it
+// belong to a section on vocabularies? Wouldn't it be better to add
+// an example of 'following your nose' to a vocabulary?</p> OK
<p>The RDF data model provides a way to make statements about
(Web) resources. As we mentioned, this data model does not make any
assumptions about what these resources stand for. In practice, RDF
is typically used in combination with vocabularies or other
conventions that provide semantic information about these
- resources. For example, if you put the VIAF IRI for Leonardo da
- Vinci (see Sec. <a href="#subsection-IRI">"IRI"</a>) in your
- browser you will see a page with information about this
- person. VIAF maintains a very large set of such person
- records.</p>
+ resources. </p>
- <p class="note">Your browser will display a HTML page. Content
- negotiation [[WEBARCH]] allows you to get the data in multiple
- formats, including RDF. </p>
+// <p>For example, if you put the VIAF IRI for Leonardo da
+// Vinci (see Sec. <a href="#subsection-IRI">"IRI"</a>) in your
+// browser you will see a page with information about this
+// person. VIAF maintains a very large set of such person
+// records.</p>
+//
+// <p class="note">Your browser will display a HTML page. Content
+// negotiation [[WEBARCH]] allows you to get the data in multiple
+// formats, including RDF. </p>
<p>To support the definition of vocabularies RDF provides a
vocabulary description language called RDF-Schema