From 95dda58ce59b30fa4331c55abce3e027985c1150 Mon Sep 17 00:00:00 2001 From: "W. Trevor King" Date: Wed, 28 Sep 2016 21:27:17 -0700 Subject: [PATCH] descriptor: Rephrase reserved wording We're not forbidding other OCI specs from using these fields, we're forbidding all specs (except for future versions of image-spec) from using these fields [1,2]. The wording I'm bringing in here matches what 873b9b64 (Add some text about extensions, 2016-06-26, #164) landed for the org.opencontainers.* annotation namespace. My personal preference would be to use JSON-LD to assign explicit semantics to every field (after which you don't have to worry about namespacing the fields themselves) [3], but that would be a larger change ;). [1]: https://github.com/opencontainers/image-spec/pull/111#r65460193 [2]: https://github.com/opencontainers/image-spec/pull/111#r65659259 [3]: https://github.com/opencontainers/image-spec/pull/111#r65468737 And later comments in that sub-thread. Signed-off-by: W. Trevor King --- descriptor.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/descriptor.md b/descriptor.md index 70056fa6f..98821943e 100644 --- a/descriptor.md +++ b/descriptor.md @@ -38,7 +38,7 @@ The following fields contain the primary properties that constitute a Descriptor ### Reserved -The following field keys MUST NOT be used in descriptors specified in other OCI specifications: +The following field keys are reserved and MUST NOT be used by other specifications. - **`data`** *string*