Skip to content
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

Clarify the meaning of multi-part OSLC Core 3.0 specification re: conformance #28

Open
jamsden opened this issue Dec 11, 2018 · 4 comments
Assignees
Labels

Comments

@jamsden
Copy link
Owner

jamsden commented Dec 11, 2018

It was not clear exactly what OSLC Core is. Is it:
1. All of the specifications - any compliant server would be expected to implement all of the capabilities (including those referenced from LDP).
2. Any of the specifications - a compliant server could advertise only one of the core capabilities, e.g., Resource Preview.

The OSLC Core Overview specification should clarify that compliance to OSLC core means with respect to the component specifications.

@jamsden jamsden self-assigned this Dec 11, 2018
@jamsden jamsden added the minor label Dec 11, 2018
@jamsden
Copy link
Owner Author

jamsden commented Dec 11, 2018

From: ndjc - I think this part is too weak: "OSLC Core Discovery may allow clients to determine what capabilities are provided." I think we need to design Core Discovery so that it does allow such determination, to at least the SHOULD level if not MUST.

@jamsden
Copy link
Owner Author

jamsden commented Dec 11, 2018

I updated the content above, and provided some motivation for even treating OSLC Discovery as optional. Since this section is non-normative, it needed specify MUST or SHOULD on discovery.

It doesn‘t seem that OSLC Core Discovery should be required. Rather a server could specify what it supports through some other means (documentation), and clients could be developed to use those capabilities (e.g., preview dialogs) without having to dynamically discover their existence.

@jamsden
Copy link
Owner Author

jamsden commented Dec 11, 2018

From: martinpain - Sounds right to me - that everything discoverable is optional (unless required by the server‘s chosen domain specification(s)), and that technically discovery itself is optional.

Re: Nick‘s comment, "The OSLC Core Discovery capability may allow clients to determine what capabilities are provided by a server." might be better as "The purpose of OSLC Core Discovery capability is to allow clients to determine what capabilities are provided by a server."

@jamsden
Copy link
Owner Author

jamsden commented Dec 11, 2018

From: ndjc - I did not intend to imply that discovery should be mandatory. However, the original wording implied that even when discovery was present, it might not allow the client to discover what capabilities are provided. Martin‘s suggested wording change fixes this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

1 participant