Going through issues
authorYves Raimond <yves.raimond@bbc.co.uk>
Wed, 13 Nov 2013 16:05:06 +0000
changeset 1317 5ad90a0cc1d5
parent 1312 ce316ae28fec
child 1318 0a3532c77e9c
Going through issues
--- a/rdf-primer/index.html	Wed Nov 13 12:29:10 2013 +0000
+++ b/rdf-primer/index.html	Wed Nov 13 16:05:06 2013 +0000
@@ -189,9 +189,6 @@
     <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> 
       <li>Adding machine-readable information to web pages using for example
       the popular <a href="http://schema.org">schema.org</a>
@@ -225,9 +222,6 @@
     <h2>RDF Data Model</h2>
-    <p class="issue">Suggest not to discuss generalized RDF in the
-    Primer</p>
     <section id="subsection-triple">
@@ -271,16 +265,6 @@
       <figcaption>Informal graph of the sample triples</figcaption>
-    <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>
     <p>In the following sections we discuss the three basic constructs
     that appear in triples, namely IRIs, literals and blank
     nodes, in more detail. </p> 
@@ -345,9 +329,6 @@
      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="note">The 2004 version of RDF contained the notion of a
      "plain literal" with no datatype. This feature has been removed as the
      distinction between "plain" literals and literals with datatype
@@ -379,8 +360,7 @@
       <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 choose not to use blank nodes. </p>
@@ -391,9 +371,6 @@
       <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>For example, the
       statements in <a href="#subsection-triple">the first example</a> could be grouped in two
       graphs. A first graph could be provided by a social networking
@@ -455,24 +432,12 @@
     <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>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>
-    <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>
+    is typically used in combination with vocabularies 
+    that provide semantic information about these
+    resources. </p>
     <p>To support the definition of vocabularies RDF provides a
     vocabulary description language called RDF-Schema