- From: gsergiu via GitHub <sysbot+gh@w3.org>
- Date: Wed, 02 Nov 2016 08:05:24 +0000
- To: public-annotation@w3.org
Yes, I do agree with what you say, this is still an open issue, and with this ticket I want to raise awarness of it. My concern and may claim is that individual pages are considered to be resources, consequently accessing the URIs/IRIs of these resources must return the same content at different points in time and by different users (possibly using additional request parameters.) In practice, this will not the case, becasue I expect that the most of the implementations will have requirements to use the pageSize. Almost all existing json based APIs are implementing like that. Offset+Limit is an equivalent representation to PageNr + PageSize... so we are talking about the same thing. And my point is that the current specifications are incomplete in this aspect. The page number is a unique identifier of the Page resource only in the case that the server doesn't allow the user to set the page size in their request. Concretely, we cannot say that the following resources are the same or even equivalent. http://example.org/annotations/?iris=1&page=1&pageSize=1 and http://example.org/annotations/?iris=1&page=1&pageSize=2 Or http://example.org/annotations/?iris=1&page=1&pageSize=10 Also .. we can say that these are actually different resources as they have different URIs, that would be also fine, only that the current specifications doesn't mentions something like that. In this case, we have annother thing that is not clear. Given that the default pageSize used by implementation is 10. How can we indicate that the following resources are the same? http://example.org/annotations/?iris=1&page=1&pageSize=10 and http://example.org/annotations/?iris=1&page=1 One possible solution is to enforce or links in the ooutput to include the pageSize, which ... would mean that the pageSize must be normative. If you don't wont to solve this issue in V1 is ok for me... but I think we should recognize this as being an open issue -- GitHub Notification of comment by gsergiu Please view or discuss this issue at https://github.com/w3c/web-annotation/issues/371#issuecomment-257797296 using your GitHub account
Received on Wednesday, 2 November 2016 08:05:30 UTC