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

Change SHALL to MAY for standard properties #17

Open
Zarquan opened this issue Jul 2, 2021 · 1 comment
Open

Change SHALL to MAY for standard properties #17

Zarquan opened this issue Jul 2, 2021 · 1 comment

Comments

@Zarquan
Copy link
Member

Zarquan commented Jul 2, 2021

The introductory text for section 3.2.4 Standard properties uses the word SHOULD to indicate that the use of these properties is recommended but not mandatory.

The following URIs SHOULD be used to represent the service properties:

However the text for the individual properties used the word SHALL, which suggests that the use of these properties is a mandatory requirement of the specification.

ivo://ivoa.net/vospace/core#title SHALL be used as the property URI denoting a name given to the resource

We should reserve the mandatory keywords MUST and SHALL for the parts of the specification that are essential for the protocol to function. The use of these common properties aids interoperability, but services and clients should be free to use different identifiers for these concepts if they need to.

See Key words for use in RFCs to Indicate Requirement Levels RFC 2119

@zonia3000
Copy link
Contributor

Pull request #20 is opened for this.

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

No branches or pull requests

2 participants