-
Notifications
You must be signed in to change notification settings - Fork 4
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 filter is unclear if result MUST only be the latest version #25
Comments
I'm for returned ONLY the latest version. |
We talked about this on the working call on 2018-01-23 and the consensus on that call was to change the text to say "MUST ONLY return the latest version". No one on the call objected to making this change. The following people were on the working call: Bret Jordan, Trey Darley, John-Mark Gurney, Sarah Kelley, Chris Ricard, Dave Lemire, Jason Keirstead, Nicholas Hayden, Richard Struse, Sunil Ravipati. |
The Version filter text specifies that when absent from a request, the most recent version should be returned. The text does not specify whether other versions are permitted. The proposed change is to clarify that only the current version should be returned, and that other versions are prohibited. |
This is now in section 3.4.1. I am thinking the text needs to be something like this:
|
A few questions about the
And, not to be pedantic, but I think it should be "MUST return only", not "MUST only return". So maybe:
I'm not a huge fan of " that the client is permitted to read.", because the server can decide to return different results to different users for whatever reason. I wonder whether the restriction is really that a "latest" query shouldn't return an version older than one that was previously returned (unless the newer version has been removed). |
+1 to this specific change. I do think some of the issues @gtback brings up should also be clarified. Specifically:
|
In section 3.4.1 the text now says:
|
Section 3.5.1
The version filter description says you MUST return the latest version if no version parameter is specified. It is not clear if this means MUST ONLY return the last version or if it includes the older versions so long as the latest one is also included.
The text was updated successfully, but these errors were encountered: