-
Notifications
You must be signed in to change notification settings - Fork 45
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Auxiliary resource for container metadata as alternative #362
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you @kjetilk, this is great.
My only suggestion (which is definitely in the bikeshedding category, so feel free to ignore) is to call this a Container Metadata Resource. To me, a Server Metadata Resource describes the server as a whole, rather than being server-managed metadata about a particular container.
Thank you very much @acoburn . I am happy to change the name. I wasn't sure what to call it, but decided to include "server" to allude to that it is server managed, but that is also made clear in the text, so I am happy to change it. |
<h4 property="schema:name">Container Metadata Resource</h4> | ||
<div datatype="rdf:HTML" property="schema:description"> | ||
<p> | ||
An auxiliary resource of type <em>Container Metadata Resource</em> provides server-maintained metadata about contained resources. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
An auxiliary resource of type <em>Container Metadata Resource</em> provides server-maintained metadata about contained resources. | |
An auxiliary resource of type <em>Container Metadata Resource</em> provides server-maintained metadata about contained resources. |
Shouldn't the type be a URI (presumably #auxiliary-resources-stat-resource
with a base I'm not quickly seeing), rather than a literal?
The Solid Editors meeting decided to merge #352 today, but indicate that the mechanism may change, so we may return to something like this later. |
Given @acoburn 's objections in https://github.com/solid/specification/pull/352/files#r764244049 and onwards, I decided to write down an alternative to #352 that introduces an auxiliary resource (hereafter known colloquially as a stat resource), as proposed by @acoburn , myself and others. We can hold these two PRs up against each other.
I believe this PR solves the following problems:
The drawbacks of this approach is, AFAICS only that NSS would have to be modified slightly and thus clients currently using these data would need to
GET
another resource. I believe this is a small cost that should be taken as soon as possible, but it is also possible that this proposal should be considered for 1.0 and not 0.9.I have in the present proposal required that this stat resource exists, and I have registered opposition to that. I believe that having this aux resource would make a fine implementation detail too, you'd record any changes on the aux resource on the backend, and so it should ease implementation too. If it is still insisted that this should be optional if it is too expensive, then I suggest that we make the discovery sentence a SHOULD, as if there is no discovery, there's no stat resource.
I think that further work on this should include making data for representations explicit, things like size and media type shouldn't be on the resource, but on the representations.