From 5f3148525b82017cb470ff5f54b37aae4003eb07 Mon Sep 17 00:00:00 2001 From: Vincent Batts Date: Wed, 27 Oct 2021 16:15:35 -0400 Subject: [PATCH] *.md: bring mediaType out of reserved status Signed-off-by: Vincent Batts --- image-index.md | 5 +++-- manifest.md | 5 +++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/image-index.md b/image-index.md index c0a2ca4d3..2db34fc28 100644 --- a/image-index.md +++ b/image-index.md @@ -17,8 +17,9 @@ For the media type(s) that this document is compatible with, see the [matrix][ma - **`mediaType`** *string* - This property is *reserved* for use, to [maintain compatibility][matrix]. - When used, this field contains the media type of this document, which differs from the [descriptor](descriptor.md#properties) use of `mediaType`. + This property SHOULD be used and [remain compatible][matrix] with earlier versions of this specification and with other similar external formats. + When used, this field MUST contain the media type `application/vnd.oci.image.index.v1+json`. + This field usage differs from the [descriptor](descriptor.md#properties) use of `mediaType`. - **`manifests`** *array of objects* diff --git a/manifest.md b/manifest.md index b05ccc7d1..8676045cb 100644 --- a/manifest.md +++ b/manifest.md @@ -22,8 +22,9 @@ Unlike the [image index](image-index.md), which contains information about a set - **`mediaType`** *string* - This property is *reserved* for use, to [maintain compatibility](media-types.md#compatibility-matrix). - When used, this field contains the media type of this document, which differs from the [descriptor](descriptor.md#properties) use of `mediaType`. + This property SHOULD be used and [remain compatible](media-types.md#compatibility-matrix) with earlier versions of this specification and with other similar external formats. + When used, this field MUST contain the media type `application/vnd.oci.image.manifest.v1+json`. + This field usage differs from the [descriptor](descriptor.md#properties) use of `mediaType`. - **`config`** *[descriptor](descriptor.md)*