1/
"orderedItems" shows up in the examples in the ActivityStreams Vocabulary spec:
https://www.w3.org/TR/activitystreams-vocabulary
But, I don't see a definition for "orderedItems" in there (in the ActivityStreams Vocabulary spec).
3/
However, "orderedItems" is mentioned in the ActivityStreams Core spec:
https://www.w3.org/TR/activitystreams-core/
Maybe the closest thing to a definition is:
"Collection are represented using the 'items' property while ordered items are represented using the 'orderedItems' property."
So, "orderedItems" is just like "items":
https://www.w3.org/TR/activitystreams-vocabulary/#dfn-items
... except renamed and the interpretation is different
@reiver to me the distinction between items and orderedItems seemed rather flimsy. It introduces a separation that has no practical benefit in my opinion.
As the ordered collection doesn't have any way to express the logic for the ordering, it might as well not exist as a separate ActivityStreams object and it just serves to introduce friction for no benefit.
This is all json-ld nonsense. orderedItems is an alias for items, signifying that the json array should be treated as a list and not a set, see
"orderedItems": {
"@container": "@list",
"@id": "as:items",
"@type": "@id"
},
in the json-ld context.