Skip to content

Improve the hyper-schema abstract #461

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 9, 2017

Conversation

handrews
Copy link
Contributor

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

@handrews handrews added this to the draft-07 milestone Oct 31, 2017
@handrews handrews changed the title Improve the abstract Improve the hyper-schema abstract Oct 31, 2017
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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you mean "JSON-based format"?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Heh. Yup, thanks, will fix.

@handrews
Copy link
Contributor Author

handrews commented Nov 9, 2017

Given the two approvals and the only comment from the third person being a trivial typo, I'm going to go ahead and merge now the the typo is fixed.

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
Copy link
Member

@awwright awwright left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Next we might want to look at reworking the first sentence, coming back to this it's not immediately apparent what is meant by "vocabularies" (even though I wrote it).

@handrews
Copy link
Contributor Author

handrews commented Nov 9, 2017

@awwright good point on "vocabularies".

@handrews handrews merged commit 92d3774 into json-schema-org:master Nov 9, 2017
@handrews handrews deleted the abstract branch November 9, 2017 22:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants