*.md: bring mediaType out of reserved status · opencontainers/image-spec@5f31485 (original) (raw)

2 files changed

lines changed

Original file line number Diff line number Diff line change
@@ -17,8 +17,9 @@ For the media type(s) that this document is compatible with, see the [matrix][ma
17 17
18 18 - **`mediaType`** *string*
19 19
20 - This property is *reserved* for use, to [maintain compatibility][matrix].
21 - When used, this field contains the media type of this document, which differs from the [descriptor](descriptor.md#properties) use of `mediaType`.
20 + This property SHOULD be used and [remain compatible][matrix] with earlier versions of this specification and with other similar external formats.
21 + When used, this field MUST contain the media type `application/vnd.oci.image.index.v1+json`.
22 + This field usage differs from the [descriptor](descriptor.md#properties) use of `mediaType`.
22 23
23 24 - **`manifests`** *array of objects*
24 25
Original file line number Diff line number Diff line change
@@ -22,8 +22,9 @@ Unlike the [image index](image-index.md), which contains information about a set
22 22
23 23 - **`mediaType`** *string*
24 24
25 - This property is *reserved* for use, to [maintain compatibility](media-types.md#compatibility-matrix).
26 - When used, this field contains the media type of this document, which differs from the [descriptor](descriptor.md#properties) use of `mediaType`.
25 + 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.
26 + When used, this field MUST contain the media type `application/vnd.oci.image.manifest.v1+json`.
27 + This field usage differs from the [descriptor](descriptor.md#properties) use of `mediaType`.
27 28
28 29 - **`config`** *[descriptor](descriptor.md)*
29 30