-
Notifications
You must be signed in to change notification settings - Fork 4
Version announcement #207
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
Version announcement #207
Conversation
spec/index.html
Outdated
<p class="note">As HTTP <a data-cite="webarch#frag-coneg">content negotiation</a> is advisory, | ||
clients recieving a document should be prepared to properly handle a document | ||
of the requested media type but potentially having a `version` other than what was | ||
requested. | ||
Systems may consider down-grading the content to an appropriate version | ||
as discussed in <a href="#defined-version-labels" class="sectionRef"></a>, | ||
or by returning a `406 "Not Acceptable"` status in the response.</p> |
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.
Does "Systems" in the second sentence refer to clients (as mentioned in the first sentence) or to servers?
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.
Probably better to use "Clients" to be consistent. I'll do an update for this later today.
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.
But clients wouldn't return a 406, as the sentence would suggest after this change.
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.
This came from a suggestion in the document, that if a client had requested 1.1, but received 1.2 they could do the downgrade on their side. Not unlike how in JSON-LD clients may receive a document and re-frame it or apply a context to get it into a better format. However, the 406 would not be something a client would do.
Suggestions from @hartig. Co-authored-by: Olaf Hartig <[email protected]>
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.
Small stuff
Co-authored-by: Ted Thibodeau Jr <[email protected]> Co-authored-by: Olaf Hartig <[email protected]>
Server and parser behavior on unexpected version announcement.
Also: Mark "atomic" term as exported to silence warnings.
Fixes #161. Fixes #205.
See also w3c/rdf-star-wg#161 and Minutes from 2025-02-29.
Preview | Diff