LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
authorJohn Arwe
Mon, 19 May 2014 09:28:00 -0400
changeset 601 5fc4b4b9efc2
parent 600 67d13fb3a21f
child 602 1635e6ae842c
LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
ldp-paging.html
ldp.html
--- a/ldp-paging.html	Mon May 12 07:34:25 2014 -0400
+++ b/ldp-paging.html	Mon May 19 09:28:00 2014 -0400
@@ -1,6 +1,12 @@
 
 <!DOCTYPE html>
 <!-- 
+	TODO: http://www.w3.org/2013/meeting/ldp/2014-04-17 resolution 3: spec sandro's paging proposal
+	TODO: http://www.w3.org/2012/ldp/track/issues/94 -> http://www.w3.org/2013/meeting/ldp/2014-05-12#resolution_3 2014-04-17 resolution 3: spec sandro's paging proposal
+	TODO: http://www.w3.org/2013/meeting/ldp/2014-04-17 resolution 4: page size hint
+	TODO: http://www.w3.org/2013/meeting/ldp/2014-04-17 resolution 5: contains+member triple always on same page
+	TODO: http://www.w3.org/2013/meeting/ldp/2014-05-12 resolution 4: ordering undefined when paging non-LDPC LDPRs
+	
 	TODO: Missing link header for equivalent of ldp:pageOf? Need to verify.  Also we have ldp-paging:pageOf in samples
 			but it doesn't exist in rules or vocabulary doc, oversight?
 	TODO: Example 11 is missing ldp:contains, true?  Omit due to GET on page resource, should make it more clear.
@@ -224,6 +230,47 @@
 <section id="terms">
 <h1>Terminology</h1>
 
+<section id="terms-from-ldp">
+<h2>Terms re-used from [[!LDP]].</h2>
+
+<p>This section is non-normative.  It summarizes a subset of terms formally defined in [[!LDP]] for the reader's convenience.
+</p>
+  <dl class="glossary">	
+
+	<dt><dfn>LDP server</dfn></dt>
+	<dd>A conforming HTTP server [[!HTTP11]] that follows the rules defined by [[!LDP]]
+	    when it is serving LDPRs and LDPCs.
+	<p></p></dd>	
+
+	<dt><dfn>LDP client</dfn></dt>
+	<dd>A conforming HTTP client [[!HTTP11]] that follows the rules defined by [[!LDP]] when
+	    interacting with a <a title="">LDP server</a>.
+	<p></p></dd>	
+
+	<dt><dfn>Linked Data Platform Resource</dfn> (<abbr title="Linked Data Platform Resource">LDPR</abbr>)</dt>
+	<dd>A HTTP resource whose state is represented in any way that conforms to the 
+		patterns and conventions in [[!LDP]].<p></p></dd>
+		
+	<dt><dfn>Linked Data Platform RDF Source</dfn> (<abbr title="Linked Data Platform RDF Source">LDP-RS</abbr>)</dt>
+	<dd>An <a title="Linked Data Platform Resource">LDPR</a> whose state is fully represented in RDF.
+	<p></p></dd>	
+
+	<dt><dfn>Membership triples</dfn></dt>
+	<dd>A set of triples that lists an <a title="Linked Data Platform RDF Source">LDP-RS's</a> members.
+	<p></p></dd>
+	
+	<dt><dfn>Containment triples</dfn></dt>
+	<dd>
+	A set of triples, maintained by an LDPC, that lists documents created by the LDPC but not yet deleted.
+	<p></p></dd>
+
+  </dl>
+
+</section>
+    
+<section id="terms-from-paging">
+<h2>Terms normatively defined by this specification</h2>
+
 <p>Terminology is based on W3C's Architecture of the World Wide Web [[WEBARCH]], Hyper-text Transfer Protocol [[HTTP11]] and Linked Data Platform [[LDP]].
 </p>
   <dl class="glossary">	
@@ -290,6 +337,7 @@
 	<p></p></dd>
 	
   </dl>
+</section>
 
 <section id="conventions">
 <h2>Conventions Used in This Document</h2>
@@ -965,6 +1013,7 @@
 <!-- <blockquote><em><a href="http://www.w3.org/TR/2013/WD-ldp-paging-20140930/">Candidate Recommendation Draft</a></em></blockquote> wah -->
 <!-- <blockquote><em><a href="http://www.w3.org/TR/2013/WD-ldp-paging-20140730/">Last Call Draft</a></em></blockquote> -->
 <ul>
+	<li>2014-05-15 - Fixed Respec messages by adding "terminology from LDP" section (JA) </li>
 	<li>2014-03-10 - Fixed namespaces (SS) </li>
 	<li>2014-02-18 - Split off LDP-Paging from LDP (SS) </li>
 </ul>
--- a/ldp.html	Mon May 12 07:34:25 2014 -0400
+++ b/ldp.html	Mon May 19 09:28:00 2014 -0400
@@ -352,13 +352,15 @@
 	<p></p></dd>
 		 
 	<dt><dfn>Membership</dfn></dt>
-	<dd>The relationship linking an LDP-RS (LDPCs are also LDP-RSs) and its member LDPRs, 
+	<dd>The relationship linking an LDPC and its member LDPRs, 
 	which can be different resources than its <a title="Containment">contained</a> documents.  
-	There often is a linked LDPC that assists with managing the member LDPRs.<p></p></dd>
+	The LDPC often assists with managing the membership triples, whether or not the LDPC's
+	URI occurs in them.
+	<p></p></dd>
 
 	<dt><dfn>Membership triples</dfn></dt>
-	<dd>A set of triples that lists an LDP-RS's members.
-		A LDP-RS's membership triples all have one of the following patterns:
+	<dd>A set of triples that lists an LDPC's members.
+		A LDPC's membership triples all have one of the following patterns:
 		<table class="indented">
 		<tr>
 		<td style="background:#DDDDDD"> <var>membership-constant-URI</var> </td>
@@ -385,7 +387,7 @@
 	<p></p></dd>
 	
 	<dt><dfn>Membership predicate</dfn></dt>
-	<dd>The predicate of all an LDP-RS's <a title="Membership triples">membership triples</a>.
+	<dd>The predicate of all an LDPC's <a title="Membership triples">membership triples</a>.
 	<p></p></dd>
 	
 	<dt><dfn>Containment</dfn></dt>
@@ -402,7 +404,7 @@
 
 	<dt><dfn>Minimal-container triples</dfn></dt>
 	<dd>
-	The portion of an LDPC's state that would be present when the container is empty.  Currently, this definition
+	The portion of an LDPC's triples that would be present when the container is empty.  Currently, this definition
 	is equivalent to all the LDPC's triples minus its containment triples, 
 	and minus its membership triples (if either are considered part of its state), 
 	but if future versions of LDP define additional classes of triples then this definition
@@ -2373,6 +2375,7 @@
 <h2>Detailed history</h2>
 <!-- <blockquote><em><a href="http://www.w3.org/TR/2013/WD-ldp-20130930/">Candidate Recommendation Draft</a></em></blockquote> -->
 <ul>
+	<li>2014-05-19 - Revert membership definition to be about LDPCs, not LDP-RS's (JA) </li>
 	<li>2014-05-09 - Respond to Joe Ross's LC2 comments (JA) </li>
 	<li>2014-04-28 - Added usage for ldp:NonLDPSource (SS) </li>
 	<li>2014-04-28 - Clarify MUST etags on responses with representations and HEAD (SS) </li>