From e06c3585a4b6720f00fd00027e67ca4b107d5f3f Mon Sep 17 00:00:00 2001
From: Henry Andrews <henry@cloudflare.com>
Date: Thu, 23 Mar 2017 13:53:37 -0700
Subject: [PATCH] Add non-http "method": "post" LDO example

Add an example showing how a non-HTTP URI scheme can be used,
showing a form for constructing an email with two different
representations, as well as requiring a subject.
---
 jsonschema-hyperschema.xml | 47 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 46 insertions(+), 1 deletion(-)

diff --git a/jsonschema-hyperschema.xml b/jsonschema-hyperschema.xml
index f5d65c23..dbfb826f 100644
--- a/jsonschema-hyperschema.xml
+++ b/jsonschema-hyperschema.xml
@@ -918,9 +918,54 @@ GET /foo/
 ]]>
                             </artwork>
                         </figure>
-
+                    </t>
+                    <t>
                         If the method is "post", "application/json" is the default media type.
                     </t>
+                    <t>
+                        As noted under <xref target="method">method</xref>, these fields
+                        are not restricted to HTTP URIs.
+
+                        <figure>
+                            <preamble>
+                                For example, this link indicates that if you want to
+                                send an email to the author of the context resource,
+                                your client needs to ask for both a plain text
+                                and an HTML representation.
+                            </preamble>
+                            <artwork>
+<![CDATA[{
+    "links": [{
+        "encType": "multipart/alternative; boundary=abc123",
+        "method": "post",
+        "rel": "author",
+        "href": "mailto:someone@example.com{?subject}",
+        "hrefSchema": {
+            "type": "object",
+            "properties": {
+                "subject": { "type": "string" }
+            },
+            "required": ["subject"]
+        },
+        "schema": {
+            "type": "array",
+            "items": [
+                {
+                    "type": "string",
+                    "media": { "type": "text/plain; charset=utf8" }
+                },
+                {
+                    "type": "string",
+                    "media": { "type": "text/html" }
+                }
+            ],
+            "minItems": 2
+        }
+    }]
+}]]>
+                            </artwork>
+                        </figure>
+                    </t>
                 </section>
 
                 <section title="schema" anchor="schema">