Minor tweaks to Named Graphs section
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Wed, 27 Mar 2013 11:16:10 +0100
changeset 1479 2a9d64e5a231
parent 1478 f6c3d7b492bb
child 1480 821d1a9fb2cb
Minor tweaks to Named Graphs section

This addresses #224.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Tue Mar 26 19:07:33 2013 +0100
+++ b/spec/latest/json-ld-syntax/index.html	Wed Mar 27 11:16:10 2013 +0100
@@ -2071,14 +2071,16 @@
   <!--
   {
     "@context": {
-      "generatedAt": "http://www.w3.org/ns/prov#generatedAtTime",
+      "generatedAt": {
+        "@id": "http://www.w3.org/ns/prov#generatedAtTime",
+        "@type": "http://www.w3.org/2001/XMLSchema#date"
+      },
       "Person": "http://xmlns.com/foaf/0.1/Person",
       "name": "http://xmlns.com/foaf/0.1/name",
-      "knows": "http://xmlns.com/foaf/0.1/knows",
-      "xsd": "http://www.w3.org/2001/XMLSchema#"
+      "knows": "http://xmlns.com/foaf/0.1/knows"
     },
     ****"@id": "http://example.org/graphs/73",
-    "generatedAt": { "@value": "2012-04-09", "@type": "xsd:date" },
+    "generatedAt": "2012-04-09",
     "@graph":****
     [
       {
@@ -2098,12 +2100,11 @@
   -->
   </pre>
 
-  <p>The example above expresses a <em>named</em> <tref>JSON-LD graph</tref>
-    that is identified by the <tref>IRI</tref>
-    <code>http://example.org/graphs/73</code>. That graph is composed of the
-    statements about Manu and Gregg. Metadata about the graph itself is also
-    expressed via the <code>generatedAt</code> property, which specifies when
-    the graph was generated. An alternative view of the
+  <p>The example above expresses a <tref>named graph</tref> that is identified
+    by the <tref>IRI</tref> <code>http://example.org/graphs/73</code>. That
+    graph is composed of the statements about Manu and Gregg. Metadata about
+    the graph itself is expressed via the <code>generatedAt</code> property,
+    which specifies when the graph was generated. An alternative view of the
     information above is represented in table form below:</p>
 
   <table class="example">
@@ -2175,9 +2176,10 @@
     <code>@graph</code> is considered to express the otherwise implicit
     <tref>default graph</tref>. This mechanism can be useful when a number
     of <tref title="node">nodes</tref> exist at the document's top level that
-    share the same <tref>context</tref>. The <code>@graph</code> keyword
-    collects such nodes in an <tref>array</tref> and allows the use of a
-    shared context.</p>
+    share the same <tref>context</tref>, which is, e.g., the case when a
+    document is <a href="#flattened-document-form">flattened</a>. The
+    <code>@graph</code> keyword collects such nodes in an <tref>array</tref>
+    and allows the use of a shared context.</p>
 
   <pre class="example" data-transform="updateExample"
     title="Using @graph to explicitly express the default graph">