Closed aschrijver closed 9 months ago
The first, next, prev, last, and current properties are used to reference other CollectionPage instances that contain additional subsets of items from the parent collection.
Collection instances may be ordered or unordered. If you Collection is truly randomly ordered throughout it's entire paging then it doesn't make sense to specify this property.
But if your collection's paging is ordered while the items within are not (for example, if your collection was the result of a query like ?before=id&after=id
and your pagination increases along id
, but no order was imposed during the serialization) then there are situations when it would make sense to specify this property.
But overall, for any given Collection, if there is no page that contains the "most recently updated items" then there is no reason to include current
Hmm, yes. Thank you. I think I don't need a current
property for now :)
@aschrijver Do you have unresolved concerns on this open issue?
Personally, no. I will not use current
. But overall I wonder whether a clearer explanation in the spec would be helpful. You can close, if you find that not the case.
@aschrijver I added a section to the primer page on Collections about this property to make it clearer.
https://www.w3.org/wiki/Activity_Streams/Primer/Collections#current_property
I think that resolves this issue, so I'll close it if you're satisfied.
Thank you @evanp. Yes, that is well described :+1:
Please Indicate One:
Please Describe the Issue in https://www.w3.org/TR/activitystreams-vocabulary:
Collection#current:
current
returns a CollectionPage or a Link (to a CollectionPage?) I presume the query is intended to be something like "Give me the N most recently updated items", where N equals the page-size.If
current
was consistent in its meaning and related to paging then:Collection
current would contain the (unordered) first page of the full collection filtered byupdated
propertyOrderedCollection
that is ordered byupdated
property, it would just return the first pageBut if the other interpretation is also valid, then how can I convey the meaning of
current
? Is there a best practice? More in general this leads me to 2 questions for which I'll create separate issues: