Updated LDPR paging section with new non-container example
authorsspeiche
Mon, 15 Jul 2013 09:02:20 -0400
changeset 198 8afbf5c571e1
parent 197 8b65b654a90c
child 199 7394aac12bea
Updated LDPR paging section with new non-container example
ldp.html
--- a/ldp.html	Mon Jul 15 14:50:51 2013 +0200
+++ b/ldp.html	Mon Jul 15 09:02:20 2013 -0400
@@ -2,7 +2,7 @@
 <!-- 
  Editor TODO:
    - Incorporate ISSUE-37 text from Ashok
-   - Fix up LDPR paging sample to remove container
+   - Insert ldp:membershipObject
    - Should we remove / hide "Change History" section?
    - Generate HTML DIFF version
  -->
@@ -644,10 +644,10 @@
 	<p>
 		To address this problem, LDPRs should support a technique called Paging.  Paging can be achieved with a
 		simple RDF pattern. For each resource, <code>&lt;resourceURL&gt;</code>, we define a new
-		'first page' resource.  In this example, its URL will be <code>&lt;containerURL&gt;?firstPage</code>,
+		'first page' resource.  In this example, its URL will be <code>&lt;resourceURL&gt;?firstPage</code>,
 		but servers are free to construct the URL as they see fit.
 		The triples in the representation of the each page
-		are a subset of the triples in the resource
+		are typically a subset of the triples in the resource
 		- same subject, predicate and object.
 	</p>
 	<p>LDPR servers may respond to requests for a
@@ -655,48 +655,46 @@
 		using a 303 “See Other” redirect to the actual URL for the page
 		resource.</p>
 	<p>
-		Looking at an example resource representing JohnZSmith's net
-		worth, we’ll split the response across two pages.  
+		Looking at an example resource representing Example Co.'s customer
+		relationship data, we’ll split the response across two pages.  
 		To find the URL of the first page, the client makes a <code>OPTIONS</code> request
 		to the resource's URL, and in the response looks for a HTTP <code>Link</code>
 		header with <code>rel="first"</code>; the target URI in the header is the URL
 		of the first page resource.
 		The client then 
-		requests the first page as <code>http://example.org/netWorth/nw1/assetContainer/?firstPage</code>:
+		requests the first page as <code>ttp://example.org/customer-relations?firstPage</code>:
 	</p>
+
 <pre class="example"># The following is the representation of
-#    http://example.org/netWorth/nw1/assetContainer/?firstPage
+#    http://example.org/customer-relations?firstPage
 @prefix rdf: &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#&gt;.
 @prefix dcterms: &lt;http://purl.org/dc/terms/&gt;.
+@prefix foaf: &lt;http://xmlns.com/foaf/0.1/&gt;.
 @prefix ldp: &lt;http://www.w3.org/ns/ldp#&gt;.
 @prefix o: &lt;http://example.org/ontology/&gt;.
 
-&lt;http://example.org/netWorth/nw1/assetContainer/&gt;
-   a ldp:Container;
-   dcterms:title "The assets of JohnZSmith";
-   ldp:membershipSubject &lt;http://example.org/netWorth/nw1&gt;;
-   ldp:membershipPredicate o:asset.
+&lt;http://example.org/customer-relations&gt;
+   a o:CustomerRelations;
+   dcterms:title "The customer information for Example Co.";
+   o:client &lt;client#JohnZSmith&gt;, &lt;client#BettyASmith&gt;, &lt;client#JoanRSmith&gt;. 
 
-&lt;http://example.org/netWorth/nw1/assetContainer/?firstPage&gt;
+&lt;http://example.org/customer-relations?firstPage&gt;
    a ldp:Page;
-   ldp:pageOf &lt;http://example.org/netWorth/nw1/assetContainer/&gt;;
-   ldp:nextPage &lt;http://example.org/netWorth/nw1/assetContainer/?p=2&gt;.
- 
-&lt;http://example.org/netWorth/nw1&gt;
-    a o:NetWorth;
-	o:asset
-	&lt;http://example.org/netWorth/nw1/assetContainer/a1&gt;,
-	&lt;http://example.org/netWorth/nw1/assetContainer/a4&gt;,
-	&lt;http://example.org/netWorth/nw1/assetContainer/a3&gt;,
-	&lt;http://example.org/netWorth/nw1/assetContainer/a2&gt;.
+   ldp:pageOf &lt;http://example.org/customer-relations&gt;;
+   ldp:nextPage &lt;http://example.org/customer-relations?p=2&gt;.
 
-&lt;http://example.org/netWorth/nw1/assetContainer/a1&gt;
-   a o:Stock;
-   o:value 100.00.
-&lt;http://example.org/netWorth/nw1/assetContainer/a2&gt;
-   a o:Cash;
-   o:value 50.00.
-# server initially supplied no data for a3 and a4 in this response</pre>
+&lt;client#JohnZSmith&gt;
+   a foaf:Person;
+   o:status o:ActiveCustomer;
+   foaf:name "John Z. Smith".
+&lt;client#BettyASmith&gt;
+   a foaf:Person;
+   o:status o:PreviousCustomer;
+   foaf:name "Betty A. Smith".
+ &lt;client#BettyASmith&gt;
+   a foaf:Person;
+   o:status o:PotentialCustomer;
+   foaf:name "Joan R. Smith".</pre>
 
 	<p>
 		The following example is the result of retrieving the representation
@@ -704,41 +702,35 @@
 	</p>
 
 <pre class="example"># The following is the representation of
-#  http://example.org/netWorth/nw1/assetContainer/?p=2
+#  http://example.org/customer-relations?p=2
 @prefix rdf: &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#&gt;.
 @prefix dcterms: &lt;http://purl.org/dc/terms/&gt;.
+@prefix foaf: &lt;http://xmlns.com/foaf/0.1/&gt;.
 @prefix ldp: &lt;http://www.w3.org/ns/ldp#&gt;.
 @prefix o: &lt;http://example.org/ontology/&gt;.
 
-&lt;http://example.org/netWorth/nw1/assetContainer/&gt;
-   a ldp:Container;
-   dcterms:title "The assets of JohnZSmith";
-   ldp:membershipSubject &lt;http://example.org/netWorth/nw1&gt;;
-   ldp:membershipPredicate o:asset.
-
-&lt;http://example.org/netWorth/nw1/assetContainer/?p=2&gt;
+&lt;http://example.org/customer-relations&gt;
+   o:client &lt;client#GlenWSmith&gt;, &lt;client#AlfredESmith&gt;. 
+ 
+&lt;http://example.org/customer-relations?p=2&gt;
    a ldp:Page;
-   ldp:pageOf &lt;http://example.org/netWorth/nw1/assetContainer/&gt;;
+   ldp:pageOf &lt;http://example.org/customer-relations&gt;;
    ldp:nextPage rdf:nil.
 
-&lt;http://example.org/netWorth/nw1&gt;
-   a o:NetWorth;
-   o:asset 
-      &lt;http://example.org/netWorth/nw1/assetContainer/a5&gt;.
+&lt;client#GlenWSmith&gt;
+   a foaf:Person;
+   o:status o:ActiveCustomer, o:GoldCustomer;
+   foaf:name "Glen W. Smith".
 
-&lt;http://example.org/netWorth/nw1/assetContainer/a5&gt;
-   a o:Stock;
-   dcterms:title "Big Co.";
-   o:value 200.02.</pre>
-
+&lt;client#AlfredESmith&gt;
+   a foaf:Person;
+   o:status o:ActiveCustomer, o:BronzeCustomer;
+   foaf:name "Alfred E. Smith".</pre>
 	<p>
-		In this example, there is only one member in the container in the
+		In this example, there is only two customers provided in the
 		final page.  To indicate this is the last page, a value of <code>rdf:nil</code> is used for the <code>ldp:nextPage</code>
 		predicate of the page resource.
 	</p>
-	<p>LDPC guarantees that any and all the triples
-		about the members will be on the same page as the membership triple
-		for the member.</p>		
 </section>
 
 <section>
@@ -1892,6 +1884,7 @@
 <blockquote><em><a href="http://www.w3.org/TR/2013/WD-ldp-20130701/">Third Public Working Draft</a></em></blockquote>
 -->
 <ul>
+	<li>2013-07-11 - Improving working in <a href="#ldpr-Paging" class="sectionRef"></a> to remove container references (SS)</li>
 	<li>2013-07-11 - Removed 4.1.5, section number fixup:4.1.8-13-&gt;6-11, 4.9.2.* fixup, 5.3.7-10-&gt;>2-5 (SS)</li>
 	<li>2013-07-11 - Removed all stubbed out sections 5.1.3, 5.3.2-6 (SS)</li>
 	<li>2013-07-11 - Various editorial clean up items from editor todo list (SS)</li>