-
-
Notifications
You must be signed in to change notification settings - Fork 313
Add "headerSchema" #390
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
Add "headerSchema" #390
Conversation
jsonschema-hyperschema.xml
Outdated
<t> | ||
<cref> | ||
As with "targetHints", this keyword is somewhat under-specified | ||
to encourage experiementation and feedback as we try to balance |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
typo: experiementation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It's extra-experimental and experiential!
2ace99d
to
92c12b8
Compare
links.json
Outdated
@@ -38,6 +38,12 @@ | |||
"mediaType": { | |||
"type": "string" | |||
}, | |||
"headerSchema": { | |||
"description": "Schema for protocol-specific headers or analogous data, as signified by URI scheme", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe drop "description" here as well?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
srsly? I swear I've pushed three times as many rebases/fixes as there are PRs tonight...
This addresses the request half of json-schema-org#296, and is a companion keyword to "targetHints" (json-schema-org#383). Like "targetHints", this is a rough first pass to get the discussion of specifics started. I expect it to be somewhat underspecified to encourage experimentation. I intentionally chose an example that is both very complex and very useful. It might also be worth putting up a simpler example. Although when this appears right after "targetHints", the simpler header value examples in that section will help motivate what is going on here.
Last call- barring objections or reasonable requests for more time to review, this will get merged tomorrow. |
This addresses the request half of #296, and is a companion
keyword to "targetHints" (#383).
Like "targetHints", this is a rough first pass to get the
discussion of specifics started. I expect it to be somewhat
underspecified to encourage experimentation.
I intentionally chose an example that is both very complex
and very useful. It might also be worth putting up a simpler
example. Although when this appears right after "targetHints",
the simpler header value examples in that section will help
motivate what is going on here.