diff --git a/jsonschema-hyperschema.xml b/jsonschema-hyperschema.xml index d48264a2..7cb884d0 100644 --- a/jsonschema-hyperschema.xml +++ b/jsonschema-hyperschema.xml @@ -3,6 +3,7 @@ + @@ -645,6 +646,7 @@ resource. The value MUST be a registered link relation from the IANA Link Relation Type Registry established in RFC 5988, or a normalized URI following the URI production of RFC 3986. + This property is required. @@ -668,13 +670,24 @@ Relationship definitions are not normally media type - dependent, and users are encouraged to utilize existing - accepted relation definitions. + dependent, and users are encouraged to utilize the most + suitable existing accepted relation definitions. + + When no registered relation (aside from "related") applies, users are + encouraged to mint their own extension relation types, as described in + section 4.2 of RFC 5988. The simplest + approaches for choosing link relation type URIs are to either use + a URI scheme that is already in use to identify the system's primary + resources, or to use a human-readable, non-dereferenceable URI scheme + such as "tag", defined by RFC 4151. + Extension relation type URIs need not be dereferenceable, even when + using a scheme that allows it. +
- For example, if a hyper-schema is defined: + As an example of registered relation types, if a hyper-schema is defined: &rfc2046; + &rfc4151; &rfc5789; &rfc5988; &rfc7231;