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

spec: namespace annotations defined in image spec #606

Merged
merged 1 commit into from
Mar 10, 2017

Conversation

stevvooe
Copy link
Contributor

@stevvooe stevvooe commented Mar 9, 2017

Signed-off-by: Stephen J Day stephen.day@docker.com

Closes #600

@stevvooe
Copy link
Contributor Author

stevvooe commented Mar 9, 2017

@opencontainers/image-spec-maintainers PTAL

annotations.md Outdated
@@ -9,16 +9,16 @@ Annotations MUST be a key-value map where both the key and value MUST be strings
While the value MUST be present, it MAY be an empty string.
Keys MUST be unique within this map, and best practice is to namespace the keys.
Keys SHOULD be named using a reverse domain notation - e.g. `com.example.myKey`.
Keys using the `org.opencontainers` namespace are reserved and MUST NOT be used by other specifications and extensions.
Keys using the `org.opencontainers.image` namespace are reserved and MUST NOT be used by other specifications and extensions.
Copy link
Member

Choose a reason for hiding this comment

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

i'm not opposed, but wonder how to handle the reservation of org.opencontainers prefix as well?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

How about something like this:

org.opencontainers is reserved for keys defined in Open Container Initiative (OCI) specifications and MUST NOT be used by other specifications and extensions.
Keys using the org.opencontainers.image namespace are reserved for use in the OCI Image Specification and MUST NOT be used by other specifications and extensions, including other OCI specifications.

Copy link
Contributor

Choose a reason for hiding this comment

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

SGTM

@jonboulle
Copy link
Contributor

Looks good overall, with +1 to vbatts comment and your suggested solution

Signed-off-by: Stephen J Day <stephen.day@docker.com>
@stevvooe stevvooe force-pushed the namespace-image-annotations branch from 3f18b36 to 8ec42b7 Compare March 9, 2017 22:01
@stevvooe
Copy link
Contributor Author

stevvooe commented Mar 9, 2017

@vbatts @jonboulle Fixed. PTAL.

@jonboulle
Copy link
Contributor

jonboulle commented Mar 10, 2017

LGTM, thanks!

Approved with PullApprove

@vbatts
Copy link
Member

vbatts commented Mar 10, 2017

LGTM

Approved with PullApprove

@vbatts vbatts merged commit 72622f5 into opencontainers:master Mar 10, 2017
@stevvooe stevvooe deleted the namespace-image-annotations branch March 13, 2017 18:20
@vbatts vbatts mentioned this pull request May 19, 2017
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

Successfully merging this pull request may close these issues.

3 participants