Skip to content

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

Merged
merged 4 commits into from
Sep 15, 2017
Merged

Add "headerSchema" #390

merged 4 commits into from
Sep 15, 2017

Conversation

handrews
Copy link
Contributor

@handrews handrews commented Sep 2, 2017

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.

@handrews handrews added this to the draft-07 (wright-*-02) milestone Sep 2, 2017
<t>
<cref>
As with "targetHints", this keyword is somewhat under-specified
to encourage experiementation and feedback as we try to balance
Copy link
Member

Choose a reason for hiding this comment

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

typo: experiementation

Copy link
Contributor Author

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!

@handrews handrews mentioned this pull request Sep 9, 2017
@handrews handrews force-pushed the header branch 3 times, most recently from 2ace99d to 92c12b8 Compare September 14, 2017 04:50
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",
Copy link
Member

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?

Copy link
Contributor Author

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.
@handrews
Copy link
Contributor Author

Last call- barring objections or reasonable requests for more time to review, this will get merged tomorrow.

@handrews handrews merged commit eb9682f into json-schema-org:master Sep 15, 2017
@handrews handrews mentioned this pull request Sep 15, 2017
@handrews handrews deleted the header branch September 15, 2017 22:45
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.

2 participants