From d5c58d0b3e2bfdc0541316a848c0c7b613a5f67a Mon Sep 17 00:00:00 2001 From: Henry Andrews Date: Tue, 31 Oct 2017 11:37:39 -0700 Subject: [PATCH] Improve the hyper-schema abstract Use language more in line with recent changes and recently introduced concepts. Add a little more detail about the general capabilities. This is all roughly inspired by reading the guidelineson abstracts in RFC 7322 section 4.3 --- jsonschema-hyperschema.xml | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/jsonschema-hyperschema.xml b/jsonschema-hyperschema.xml index 8614d845..c899a02b 100644 --- a/jsonschema-hyperschema.xml +++ b/jsonschema-hyperschema.xml @@ -57,10 +57,13 @@ - JSON Schema is a JSON based format for describing JSON data using various - vocabularies. This document specifies a vocabulary - for annotating JSON documents with hyperlinks and instructions for processing and - manipulating remote JSON resources through hypermedia environments such as HTTP. + JSON Schema is a JSON-based format for describing JSON data using various + vocabularies. This document specifies a vocabulary for annotating JSON + documents with hyperlinks. These hyperlinks include attributes describing + how to manipulate and interact with remote resources through hypermedia + environments such as HTTP, as well as determining whether the link is usable + based on the instance value. The hyperlink serialization format described in + this document is also usable independent of JSON Schema.