Rework '"targetSchema" and HTTP' #476
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This is an attempt to introduce concepts in a better order and generally improve the flow. Examples relevant to this section will be submitted separately once decisions are made as to where they should go.
dlax
approved these changes
Nov 7, 2017
philsturgeon
approved these changes
Nov 7, 2017
awwright
reviewed
Nov 9, 2017
jsonschema-hyperschema.xml
Outdated
| The relationship between a resource's representation and HTTP requests and | ||
| responses is determined by <xref target="RFC7231">RFC 7231, section 4.3.1 - | ||
| "GET", section 4.3.4 "PUT", and section 3.1.4.2, "Content-Location"</xref>. | ||
| "targetSchema" describes the resource on the other end of the link, while |
There was a problem hiding this comment.
"other end" might be ambiguous here (the first think I actually thought of was "link" as in "satellite link" not "Web link"). I might say "target end" (or in semweb contexts, "object end").
There was a problem hiding this comment.
Yeah I kind of worried about that. Thanks for the feedback, it helps and I'll update this.
awwright
approved these changes
Nov 9, 2017
gregsdennis
added
clarification
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This is an attempt to introduce concepts in a better order
and generally improve the flow. Examples relevant to this section
will be submitted separately once decisions are made as to where
they should go.
This hopefully addresses #469.