diff --git a/Makefile b/Makefile index 0d6c96500..05e033e82 100644 --- a/Makefile +++ b/Makefile @@ -30,7 +30,7 @@ DOC_FILES := \ layer.md \ config.md \ annotations.md \ - canonicalization.md + considerations.md FIGURE_FILES := \ img/media-types.png diff --git a/canonicalization.md b/considerations.md similarity index 84% rename from canonicalization.md rename to considerations.md index 3875ad271..e2e8f4ccd 100644 --- a/canonicalization.md +++ b/considerations.md @@ -1,3 +1,8 @@ +# Extensibility + +Implementations that are reading/processing [manifests](manifest.md) or [manifest lists](manifest-list.md) MUST NOT generate an error if they encounter an unknown property. +Instead they MUST ignore unknown properties. + # Canonicalization OCI Images [are](descriptor.md) [content-addressable](image-layout.md). diff --git a/manifest-list.md b/manifest-list.md index fe6b71775..42e51c6a3 100644 --- a/manifest-list.md +++ b/manifest-list.md @@ -71,10 +71,6 @@ For the media type(s) that this document is compatible with, see the [matrix][ma See [Pre-Defined Annotation Keys](annotations.md#pre-defined-annotation-keys). -### Extensibility -Implementations that are reading/processing manifest lists MUST NOT generate an error if they encounter an unknown property. -Instead they MUST ignore unknown properties. - ## Example Manifest List *Example showing a simple manifest list pointing to image manifests for two platforms:* diff --git a/manifest.md b/manifest.md index a720fcd90..0e8e985fe 100644 --- a/manifest.md +++ b/manifest.md @@ -66,10 +66,6 @@ Unlike the [Manifest List](manifest-list.md), which contains information about a See [Pre-Defined Annotation Keys](annotations.md#pre-defined-annotation-keys). -### Extensibility -Implementations that are reading/processing image manifests MUST NOT generate an error if they encounter an unknown property. -Instead they MUST ignore unknown properties. - ## Example Image Manifest *Example showing an image manifest:* diff --git a/spec.md b/spec.md index a6590e1ed..fdffd0e8b 100644 --- a/spec.md +++ b/spec.md @@ -18,7 +18,9 @@ The goal of this specification is to enable the creation of interoperable tools - [Filesystem Layers](layer.md) - [Image Configuration](config.md) - [Annotations](annotations.md) -- [Canonicalization](canonicalization.md) +- [Considerations](considerations.md) + - [Extensibility](considerations.md#extensibility) + - [Canonicalization](considerations.md#canonicalization) # Notational Conventions