rename empty container triples to minimal container triples
authorJohn Arwe
Tue, 15 Apr 2014 16:25:52 -0400
changeset 554 5a4fe2b38a2a
parent 553 3d27d1a1d553
child 555 94b6d308224c
child 558 63b736cb76bf
rename empty container triples to minimal container triples
ldp.html
ldp.ttl
--- a/ldp.html	Tue Apr 15 15:47:01 2014 -0400
+++ b/ldp.html	Tue Apr 15 16:25:52 2014 -0400
@@ -400,7 +400,7 @@
 	These triples <strong>always</strong> have the form: <var>( LDPC URI, ldp:contains , document-URI )</var>.
 	<p></p></dd>
 
-	<dt><dfn>Empty-container triples</dfn></dt>
+	<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
 	is equivalent to all the LDPC's triples minus its containment triples and minus its membership
@@ -1120,7 +1120,7 @@
 	below.
 	</p>
 	<table style="border: 1px solid gray" id="ldpc-mbrcntdiff">
-		<thead><tr><th rowspan="2">Completed Request</th><th colspan="2">Effects</th></tr>
+		<thead><tr><th rowspan="2">Completed Request</th><th style="background:#FFFFFF;" colspan="2">Effects</th></tr>
 		       <tr class="oddrow"><th>Membership</th><th>Containment</th></tr></thead>
 		<tr><td>LDPR created in LDP-BC</td><td>New triple: (LDPC, ldp:contains, LDPR)</td><td>Same</td></tr>
 		<tr><td>LDPR created in LDP-DC</td><td>New triple links LDP-RS to created LDPR. LDP-RS URI may be same as LDP-DC</td>
@@ -1133,14 +1133,14 @@
 			(LDPC, ldp:contains, LDPR) and contained LDPRs may be removed</td></tr>
 	</table>
 
-<section id="ldpc-get_empty-container_props"><h2 class="normal">Retrieving Only Empty-Container Triples
-	</h2><!-- Was 5.1.1 / #ldpc-get_empty-container_props -->
+<section id="ldpc-get_minimal-container_props"><h2 class="normal">Retrieving Only Minimal-Container Triples
+	</h2><!-- Was 5.1.1 / #ldpc-get_minimal-container_props -->
 	<p>The representation of a container
 		that has many members will be large. There are several important
 		cases where clients need to access only the subset of the container's properties 
 		that are unrelated to member resources and unrelated to contained documents, for
 		example to determine the membership triple pattern and membership predicate of an 
-		LDP-DC.  LDP calls these <a title="Empty-container triples">empty-container triples</a>,
+		LDP-DC.  LDP calls these <a title="Minimal-container triples">minimal-container triples</a>,
 		because they are what remains when the container has zero members and zero contained resources.
 		Since retrieving the whole container representation to
 		get this information may be onerous for clients and cause unnecessary
@@ -1152,19 +1152,19 @@
 		(see <a href="#prefer-parameters" class="sectionRef"></a> for details).
 	</p>
 	<p>The example listed here only shows
-		a simple case where few empty-container triples are
+		a simple case where few minimal-container triples are
 		retrieved. In real world situations more complex cases are likely, such as those that add other predicates to
 		containers, for example providing validation information and
 		associating SPARQL endpoints. [[sparql11-query]]</p>
 	<p>
-		Here is an example requesting the empty-container triples of a
+		Here is an example requesting the minimal-container triples of a
 		container identified by the URL <code>http://example.org/container1/</code>.
 	</p>
-<p id="ldpc-ex-empty-container">Request:</p>
+<p id="ldpc-ex-minimal-container">Request:</p>
 <pre class="example">GET /container1 HTTP/1.1
 Host: example.org
 Accept: text/turtle; charset=UTF-8
-Prefer: return=representation; include="http://www.w3.org/ns/ldp#PreferEmptyContainer"
+Prefer: return=representation; include="http://www.w3.org/ns/ldp#PreferMinimalContainer"
 </pre>
 <p>Response:</p>
 <pre class="example">HTTP/1.1 200 OK
@@ -1189,7 +1189,7 @@
 		LDP recommends using PATCH to update these properties, if necessary.  It provides no facility
 		for updating them via PUT without replacing the entire container's state.
 	</p>
-	</section><!-- ldpc-get_empty-container_props -->
+	</section><!-- ldpc-get_minimal-container_props -->
 
 </section>
 
@@ -1458,7 +1458,7 @@
 	<section id="ldpc-patch-req"><h2 class="normal">
 		<a title="LDP server">LDP servers</a> are RECOMMENDED 
 		to support HTTP <code>PATCH</code> as the preferred method for 
-		updating a LDPC's <a title="Empty-container triples">empty-container triples</a>.
+		updating a LDPC's <a title="Minimal-container triples">minimal-container triples</a>.
 	</h2></section><!-- Was 5.8.1 / #ldpc-5_8_1 -->
 </section>
 
@@ -1939,9 +1939,9 @@
 		<td> <code>http://www.w3.org/ns/ldp#PreferMembership</code> </td>
 		</tr>
 		<tr>
-		<td> <a title="Empty-container triples">Empty-container triples</a>
+		<td> <a title="Minimal-container triples">Minimal-container triples</a>
 		</td>
-		<td> <code>http://www.w3.org/ns/ldp#PreferEmptyContainer</code> </td>
+		<td> <code>http://www.w3.org/ns/ldp#PreferMinimalContainer</code> </td>
 		</tr>
 		</table>
 		<blockquote>
@@ -1992,10 +1992,10 @@
 	   o:value 300000 .
 	</pre>
 
-	<p id="prefer-examples-direct-empty-container-only1">
+	<p id="prefer-examples-direct-minimal-container-only1">
 	Clients interested only in information about the container 
 	(for example, which membership predicate it uses) might use this hint on a <code>GET</code> request:
-	<code>Prefer: return=representation; include="http://www.w3.org/ns/ldp#PreferEmptyContainer"</code>
+	<code>Prefer: return=representation; include="http://www.w3.org/ns/ldp#PreferMinimalContainer"</code>
 	</p>
 	<p>
 	A server that honors this hint would return a following response containing the HTTP header 
@@ -2020,13 +2020,13 @@
 	   ldp:insertedContentRelation ldp:MemberSubject.
 	</pre>
 
-	<p id="prefer-examples-direct-empty-container-only2">
+	<p id="prefer-examples-direct-minimal-container-only2">
 	Clients interested only in information about the container 
 	(same as before) might use this hint instead:
 	<code>Prefer: return=representation; omit="http://www.w3.org/ns/ldp#PreferMembership http://www.w3.org/ns/ldp#PreferContainment"</code>.  Note: <strong>Treating the two as equivalent is not recommended.</strong> While today this 
 	<code>omit</code> parameter value is equivalent to the preceding <code>include</code> parameter value, 
 	they may not be equivalent in the future 
-	due to the definition of <a title="Empty-container triples">empty-container triples</a>.
+	due to the definition of <a title="Minimal-container triples">minimal-container triples</a>.
 	Clients should preferentially use the <code>include</code> parameter, as it more precisely communicates their needs.
 	</p>
 	<p>
@@ -2054,7 +2054,7 @@
 	<p id="prefer-examples-direct-membershiponly">
 	Clients interested only in information about the container 
 	(for example, which membership predicate it uses) and its membership might use this hint on a <code>GET</code> request:
-	<code>Prefer: return=representation; include="http://www.w3.org/ns/ldp#PreferMembership http://www.w3.org/ns/ldp#PreferEmptyContainer"</code>
+	<code>Prefer: return=representation; include="http://www.w3.org/ns/ldp#PreferMembership http://www.w3.org/ns/ldp#PreferMinimalContainer"</code>
 	</p>
 	<p>
 	A server that honors this hint would return 
--- a/ldp.ttl	Tue Apr 15 15:47:01 2014 -0400
+++ b/ldp.ttl	Tue Apr 15 16:25:52 2014 -0400
@@ -156,10 +156,10 @@
 	rdfs:isDefinedBy :;
 	rdfs:label "PreferMembership".
 
-:PreferEmptyContainer
+:PreferMinimalContainer
  	a rdf:Description;		# individual
 	rdfs:comment "URI identifying the subset of a LDPC's triples present in an empty LDPC, for example to allow clients to express interest in receiving them.  Currently this excludes containment and membership triples, but in the future other exclusions might be added.  This definition is written to automatically exclude those new classes of triples.";
 	vs:term_status "unstable";
 	rdfs:isDefinedBy :;
-	rdfs:label "PreferEmptyContainer".
+	rdfs:label "PreferMinimalContainer".
 	
\ No newline at end of file