DATAREST-478 - Polished up bits of documentation.

Original pull request: #169.

src/main/asciidoc/customizing-sdr.adoc

@@ -1,7 +1,7 @@
 [[customizing-sdr]]
 = Customizing Spring Data REST
 
-There are many options to tailor Spring Data REST. These subsections will show how.
+There are many options to tailor Spring Data REST. These subsections show how.
 
 include::configuring-the-rest-url-path.adoc[leveloffset=+1]
 include::adding-sdr-to-spring-mvc-app.adoc[leveloffset=+1]

src/main/asciidoc/example-api-usage-with-curl.adoc

@@ -1,8 +1,8 @@
 [[example-api-usage-with-curl]]
 [appendix]
-= Using curl to talk to Spring Data REST
+= Using cURL to talk to Spring Data REST
 
-This appendix contains a list of guides that demonstrate interacting with a Spring Data REST service via curl:
+This appendix contains a list of guides that demonstrate interacting with a Spring Data REST service via cURL:
 
 * https://spring.io/guides/gs/accessing-data-rest/[Accessing JPA Data with REST]
 * https://spring.io/guides/gs/accessing-neo4j-data-rest/[Accessing Neo4j Data with REST]

src/main/asciidoc/repository-resources.adoc

@@ -45,12 +45,17 @@ curl -v http://localhost:8080/
 { "_links" : {
     "orders" : {
       "href" : "http://localhost:8080/orders"
+    },
+    "profile" : {
+      "href" : "http://localhost:8080/api/alps"
     }
   }
 }
 ----
 
-The  property of the result document is an object in itself consisting of keys representing the relation type with nested link objects as specified in HAL.
+The property of the result document is an object in itself consisting of keys representing the relation type with nested link objects as specified in HAL.
+
+NOTE: For more details about the *profile* link, see <<metadata.alps>>.
 
 [[repository-resources.collection-resource]]
 == The collection resource