Convert "list of lists not supported" note to issue marker
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Mon, 01 Apr 2013 20:35:17 +0200
changeset 1516 0ae9c19e6b97
parent 1515 0095473bb86b
child 1517 89ae204a152d
Convert "list of lists not supported" note to issue marker

as suggested by Sandro. I've just added one sentence to the text Sandro proposed:

"Lists of lists can, however, not be represented in JSON-LD using @list; they have to be represented as a set of interlinked node objects using RDF's rdf:first and rdf:rest properties."

This addresses #234.
spec/latest/json-ld-api/index.html
--- a/spec/latest/json-ld-api/index.html	Mon Apr 01 20:23:24 2013 +0200
+++ b/spec/latest/json-ld-api/index.html	Mon Apr 01 20:35:17 2013 +0200
@@ -3276,7 +3276,16 @@
       <tref>default graph</tref> and zero or more
       <tref title="named graph">named graphs</tref> into a JSON-LD document.</p>
 
-    <p class="note">This algorithm does not support lists containing lists.</p>
+    <p class="issue atrisk" title="Feature at risk">In the interest of space and
+      simplicity, the steps necessary for handling lists of lists have been omitted.
+      Such lists and their elements must, recursively, be handled like other lists.
+      Lists of lists can, however, not be represented in JSON-LD using <code>@list</code>;
+      they have to be represented as a set of interlinked node objects using RDF's
+      <code>rdf:first</code> and <code>rdf:rest</code> properties.
+      <em>NOTE:</em> this is an at-risk feature. The Working Group might either require
+      handling of lists-of-lists or forbid them in JSON-LD. Implementers please send
+      reports of whether you are able to implement handling for lists-of-lists or
+      would instead request such structures be disallowed.</p>
 
     <section class="informative">
       <h3>Overview</h3>