-
Notifications
You must be signed in to change notification settings - Fork 687
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
spec: namespace annotations defined in image spec #606
Conversation
@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. |
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.
i'm not opposed, but wonder how to handle the reservation of org.opencontainers
prefix as well?
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.
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 theorg.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.
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.
SGTM
Looks good overall, with +1 to vbatts comment and your suggested solution |
Signed-off-by: Stephen J Day <stephen.day@docker.com>
3f18b36
to
8ec42b7
Compare
@vbatts @jonboulle Fixed. PTAL. |
Signed-off-by: Stephen J Day stephen.day@docker.com
Closes #600