Merge
authorJohn Arwe
Mon, 08 Sep 2014 15:28:22 -0400
changeset 809 a60f8b94088e
parent 807 04e0b4577e41 (current diff)
parent 808 2100d73b2ad7 (diff)
child 811 df3a6d40fd5f
Merge
--- a/ldp.html	Mon Sep 08 15:25:47 2014 -0400
+++ b/ldp.html	Mon Sep 08 15:28:22 2014 -0400
@@ -1,7 +1,5 @@
 <!DOCTYPE html>
 <!-- 
-	TODO: Search for them within this document.
-	TODO: Once companion documents (best practices, primer) have URLs, link to them.  Search on "companion".
 	TODO: Add new "discovery of server capabilities" non-norm section
     TODO: Consider adding Venn diagram for differences of LDPCs
  -->
@@ -277,7 +275,18 @@
 	<p>This specification discusses standard HTTP and RDF techniques  
 	used when constructing clients and servers that 
 	create, read, and write <a title="Linked Data Platform Resource">Linked Data Platform Resources</a>.
-	A companion document discusses best practices that you 
+	<a
+			href="http://www.w3.org/TR/ldp-primer/"
+			class="external"
+			title="Linked Data Platform 1.0 Primer"
+			rel="nofollow">LDP Primer</a> 
+	provides an entry-level introduction with many examples in the context of a fictional application.
+	<a
+			href="http://www.w3.org/TR/ldp-bp/"
+			class="external"
+			title="LDP Best Practices and Guidelines"
+			rel="nofollow">LDP Best Practices and Guidelines</a> 
+			discusses best practices that you 
 	should use, and anti-patterns you should avoid, when constructing these clients and servers.
 	</p> 
 	<p>This specification defines a special type of <a>Linked Data Platform Resource</a>: a 
@@ -502,17 +511,17 @@
 		<li>How	do I GET the representation of a large resource broken up into pages?</li>
 	</ul>
 	<p>Additional non-normative guidance is available in the <a
-			href="https://dvcs.w3.org/hg/ldpwg/raw-file/default/ldp-bp/ldp-bp.html"
+			href="http://www.w3.org/TR/ldp-bp/"
 			class="external"
 			title="LDP Best Practices and Guidelines"
-			rel="nofollow">LDP Best Practices and Guidelines editor's draft</a> that addresses
+			rel="nofollow">LDP Best Practices and Guidelines</a> that addresses
 		questions such as:</p>
 	<ul>
 		<li>What literal value types should be used?</li>
 		<li>Are there some typical vocabularies that should be reused?</li>
+		<li>What guidelines exist when interacting with LDPRs that are common but are not universal enough to specify normatively?</li>
 	</ul>
 	<p>The following sections define the conformance rules for LDP servers when serving LDPRs.
-	Companion non-normative documents describe additional guidelines for use when interacting with LDPRs. 
 	</p>
 	<p>LDP-RS's representations may be too big, one strategy is to break up the response representation
 	into client consumable chunks called pages. A separate LDP specification outlines the conformance
@@ -2591,6 +2600,7 @@
 
 <blockquote><em><a href="http://www.w3.org/TR/2014/WD-ldp-20140916">Last Call Working Draft 3</a></em></blockquote> -->
 <ul>
+	<li>2014-09-08 - Add link to Best Practices now that it has been published (JA) </li>
 	<li>2014-09-08 - Indirect containers (at risk) (JA) </li>
 	<li>2014-09-08 - Should return Turtle if Accept is absent, JSON-LD required (at risk), clarify creates  (JA) </li>
 	<li>2014-09-08 - Changed the constraints link relation to ldp#constrainedBy, per today's mtg resolution  (JA) </li>