w3c / activitystreams

Activity Streams 2.0
https://www.w3.org/TR/activitystreams-core/
Other
276 stars 60 forks source link

the orderedItems property mentioned in the Activity Streams 2.0 recommendation is not defined in the Activity Vocabulary #576

Closed cristianolongoodhl closed 6 months ago

cristianolongoodhl commented 6 months ago

Please Indicate One:

Please Describe the Issue:

In https://www.w3.org/TR/activitystreams-core/#collections the orderedItems property is mentioned for representing ordered items of a collection. However I can't find this property in the Activity Vocabulary . I suggest to remove orderedItems as it is redundant with the items property of an OrderedCollection. Notice that, this property occurs in several examples for the vocabulary.

tesaguri commented 6 months ago

Note that orderedItems is defined in the normative JSON-LD context document so that it's not something that has come out of thin air.

I think there is a confusion between the terminologies property and term. The difference is crucial here because items and orderedItems are two different JSON-LD terms for the same RDF property (as:items), but with different context definitions to give each of the terms different RDF semantics for the same JSON syntax (the JSON array syntax in this case).

The items term represents multiple RDF triples with each of the array values being their objects respectively. For example, {"items": ["a", "b"]} represents something like [ as:items <a> , <b> ] . in a pseudo-Turtle. On the other hand, the orderedItems term represents a single RDF triple with its object being an rdf:List resource. For example, {"orderedItems": ["a", "b"]} represents something like [ as:items ( <a> <b> ) ] ..

So it's true that there is no RDF property named as:orderedItems in Activity Vocabulary, and the Recommendation's phrasing orderedItems property may be misleading. But I don't believe that the orderedItems term is redundant since it has a semantics distinct from items term.

See also #437.

nightpool commented 6 months ago

Yes. The orderedItems property is a required part of the JSON-LD syntax for the "items" vocabulary term when such items are ordered. it doesn't appear in the RDF document because it's not a property in and of itself, just part of the json ld syntax for representing the items property in certain cases

On Sun, Dec 31, 2023, 6:40 AM cristianolongoodhl @.***> wrote:

Please Indicate One:

  • Editorial
  • Question
  • Feedback
  • Blocking Issue
  • Non-Blocking Issue

Please Describe the Issue:

In https://www.w3.org/TR/activitystreams-core/#collections the orderedItems property is mentioned for representing ordered items of a collection. However I can't find this property in the Activity Vocabulary https://www.w3.org/TR/activitystreams-vocabulary/#properties . I suggest to remove orderedItems as it is redundant with the items property of an OrderedCollection. Notice that, this property occurs in several examples for the vocabulary.

— Reply to this email directly, view it on GitHub https://github.com/w3c/activitystreams/issues/576, or unsubscribe https://github.com/notifications/unsubscribe-auth/AABZCVZR2WABYR4ATTVVIQDYMF2NTAVCNFSM6AAAAABBIJRUIGVHI2DSMVQWIX3LMV43ASLTON2WKOZSGA3DCMBYGA3TQNQ . You are receiving this because you are subscribed to this thread.Message ID: @.***>

cristianolongoodhl commented 6 months ago

Thank you all, I think this issue can be considered a duplicate of #437

cristianolongoodhl commented 6 months ago

Note that orderedItems is defined in the normative JSON-LD context document so that it's not something that has come out of thin air.

But the "context" is part of the ActivityPub specification and not of ActivityStream, am I right? May be the specifications stack and the order in which specifications have to be read is not really clear to me.

tesaguri commented 6 months ago

But the "context" is part of the ActivityPub specification and not of ActivityStream, am I right?

Section 2.1 of the Activity Streams Recommendation refers to the context as normative.

cristianolongoodhl commented 6 months ago

Thank you very much, may I close this issue?

nightpool commented 6 months ago

Please do

cristianolongoodhl commented 6 months ago

Closed as duplicate of #437