Merge pull request #353 from handrews/description

Add "description" as an LDO keyword.

Author: handrews

hyper-schema.json

@@ -38,6 +38,10 @@
                     "description": "a title for the link",
                     "type": "string"
                 },
+                "description": {
+                    "description": "additional information about the purpose or usage of the link",
+                    "type": "string"
+                },
                 "targetSchema": {
                     "description": "JSON Schema describing the link target",
                     "allOf": [ { "$ref": "#" } ]

jsonschema-hyperschema.xml

@@ -909,14 +909,29 @@ GET /foo/
             <section title="title">
                 <t>
                     This property defines a title for the link.
-                    The value must be a string.
+                    The value MUST be a string.
                 </t>
 
                 <t>
                     User agents MAY use this title when presenting the link to the user.
                 </t>
             </section>
 
+            <section title="description">
+                <t>
+                    This property provides additional information beyond what
+                    is present in the title.  The value MUST be a string.
+                    While a title is preferably short, a description can be
+                    used to go into more detail about the purpose and usage
+                    of the link.
+                </t>
+
+                <t>
+                    User agents MAY use this description when presenting
+                    the link to the user.
+                </t>
+            </section>
+
             <section title="targetSchema" anchor="targetSchema">
                 <t>
                     This property provides a schema that is expected to describe