Skip to content

Move reference to RFC 7231 above sentence about "targetSchema" purpose #468

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

Conversation

dlax
Copy link
Member

@dlax dlax commented Nov 3, 2017

Reading the sentence about RFC 7231 (relationship between resource
representation and HTTP requests/responses) feels quite abrupt in this
section about "targetSchema and HTTP". So first restate what
"targetSchema" is meant for and then add the reference to protocol
guidelines.

Reading the sentence about RFC 7231 (relationship between resource
representation and HTTP requests/responses) feels quite abrupt in this
section about "targetSchema and HTTP". So first restate what
"targetSchema" is meant for and then add the reference to protocol
guidelines.
@handrews
Copy link
Contributor

handrews commented Nov 6, 2017

I wrote it in that order for a reason, and it seemed to be fine in draft-06. It's more important to me to motivate it from the standard document as many people claim various things about what HTTP means.

I'm open to reworking this section, but the paragraphs read very strangely to me in this order. The now-first paragraph has irrelevant minor details, and the second one doesn't connect well to the first.

@dlax
Copy link
Member Author

dlax commented Nov 6, 2017

The actual problem is that I don't get the point of the section as a whole. So I filled issue #469 for that but then felt that with the change suggested here, I might understand it better. Apparently, I'm not even going the right direction, so let's forget about this and discuss on the issue.

@dlax dlax closed this Nov 6, 2017
@handrews
Copy link
Contributor

handrews commented Nov 6, 2017

@dlax thanks, I saw #469 and didn't comment b/c I was too tired last night to come up with anything (had just walked in the door from a long drive back from vacation), but I'll think it through today and comment. It's an important section so I'm glad you are raising these issues.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants