W3C home > Mailing lists > Public > public-annotation@w3.org > November 2016

Re: [web-annotation] Next, Prev, First, Last in AnnotationCollection/AnnotationPage

From: Rob Sanderson via GitHub <sysbot+gh@w3.org>
Date: Tue, 01 Nov 2016 15:41:29 +0000
To: public-annotation@w3.org
Message-ID: <issue_comment.created-257601090-1478014887-sysbot+gh@w3.org>
> typically this is an (implementation specific) request parameter 

Typically, but not in this case.  

>From the protocol spec, section 4.2:
> The number of IRIs or Annotation descriptions included on each page 
is at the server's discretion, and may be inconsistent between pages.

We started off with the typical offset/limit pattern but decided 
against it for the following reasons:

* It's much harder to cache when every client requests different page 
sizes
* It's impossible to implement as a static set of files on disk
* The size of annotations can vary wildly, particularly if the server 
doesn't return all of the information for an annotation in the page 
response. Guessing how many to retrieve requires knowledge of the 
dataset, which is not feasible to obtain.
* It's trivial to either request pages until the number the client 
wants is reached (if per page size is less than desired), or to ignore
 annotations if the page size is greater than the number wanted.

So ... as this has been discussed, unless there is some new 
information that makes the current approach un-implementable (which 
would be strange, considering there are implementations), or some 
significant benefit that was overlooked in the original discussion, I 
propose close wontfix.

-- 
GitHub Notification of comment by azaroth42
Please view or discuss this issue at 
https://github.com/w3c/web-annotation/issues/371#issuecomment-257601090
 using your GitHub account
Received on Tuesday, 1 November 2016 15:41:36 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 18:54:50 UTC