Skip to content

Add terms used by the Access Request feature#199

Open
acoburn wants to merge 1 commit into
mainfrom
json-ld-terms
Open

Add terms used by the Access Request feature#199
acoburn wants to merge 1 commit into
mainfrom
json-ld-terms

Conversation

@acoburn

@acoburn acoburn commented Jul 14, 2026

Copy link
Copy Markdown
Member

The terms used in the Access Request feature have not been added to the vocabulary and JSON-LD context. This adds almost all of the terms to the yml2vocab configuration file.

There are two notable exceptions that need to be handled separately, and may warrant more discussion.

  1. We currently use mediaType from Activity Streams 2.0 as a defined property (used in container listings), but yml2vocab does not allow terms defined as properties in the vocabulary.yml file to be used for @vocab expansion. In order to use mediaType as the value for leftOperand, we would need to consider one of these workarounds:
  • using a different property for the leftOperand value
  • update yml2vocab to support OWL punning (at present, it only allows terms defined as named individuals if they are included in the vocabulary.yml file)
  1. The specification uses lws:StorageResource, which aligns with the term "LWS Resource". It seems like we should align these terms. The simplest approach seems to be to define a term in the vocabulary for lws:Resource and give it the same definition as LWS Resource, and secondly, change the examples and text that reference lws:StorageResource, changing that to lws:Resource.

Please note that all the terms with external: true will not appear in the LWS Turtle vocabulary, but they will appear in the JSON-LD context. In most cases those terms will be scoped to the lws:AccessPolicy context. dcterms:conformsTo remains unscoped since it is used in the service definitions of the Storage Description Resource.

@pchampin pchampin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The two suggested changes I made in this review are a workaround the punning issue for as:mediaType used as value of leftOperand. It seems to work.

Appart from that, LGTM

Comment on lines 7 to 8
- id: as
value: https://www.w3.org/ns/activitystreams#

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- id: as
value: https://www.w3.org/ns/activitystreams#
- id: as2
value: https://www.w3.org/ns/activitystreams#

(the diff above seems buggy -- this proposal is to simply add prefix as2 with the same IRI as as)

- odrl:purpose
- odrl:dateTime
- client
- dcterms:type

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- dcterms:type
- dcterms:type
- as2:mediaType

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants