Merge pull request from GHSA-77vh-xpmg-72qh

*.md: bring mediaType out of reserved status

image-index.md

@@ -18,8 +18,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*
 

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)*
 
@@ -62,7 +63,6 @@ Unlike the [image index](image-index.md), which contains information about a set
         Manifests concerned with portability SHOULD use one of the above media types.
         An encountered `mediaType` that is unknown to the implementation MUST be ignored.
 
-
         Entries in this field will frequently use the `+gzip` types.
 
 - **`annotations`** *string-string map*

media-types.md

@@ -39,7 +39,6 @@ This section shows where the OCI Image Specification is compatible with formats
 **Similar/related schema**
 
 - [application/vnd.docker.distribution.manifest.list.v2+json](https://github.com/distribution/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list)
-  - `.mediaType`: only present in Docker, and reserved in OCI
   - `.annotations`: only present in OCI
   - `.[]manifests.annotations`: only present in OCI
   - `.[]manifests.urls`: only present in OCI
@@ -49,7 +48,6 @@ This section shows where the OCI Image Specification is compatible with formats
 **Similar/related schema**
 
 - [application/vnd.docker.distribution.manifest.v2+json](https://github.com/distribution/distribution/blob/master/docs/spec/manifest-v2-2.md#image-manifest-field-descriptions)
-  - `.mediaType`: only present in Docker, and reserved in OCI
   - `.annotations`: only present in OCI
   - `.config.annotations`: only present in OCI
   - `.config.urls`: only present in OCI

specs-go/v1/index.go

@@ -21,6 +21,9 @@ import "github.com/opencontainers/image-spec/specs-go"
 type Index struct {
 	specs.Versioned
 
+	// MediaType specificies the type of this document data structure e.g. `application/vnd.oci.image.index.v1+json`
+	MediaType string `json:"mediaType,omitempty"`
+
 	// Manifests references platform specific manifests.
 	Manifests []Descriptor `json:"manifests"`
 

specs-go/v1/manifest.go

@@ -20,6 +20,9 @@ import "github.com/opencontainers/image-spec/specs-go"
 type Manifest struct {
 	specs.Versioned
 
+	// MediaType specificies the type of this document data structure e.g. `application/vnd.oci.image.manifest.v1+json`
+	MediaType string `json:"mediaType,omitempty"`
+
 	// Config references a configuration object for a container, by digest.
 	// The referenced configuration object is a JSON blob that the runtime uses to set up the container.
 	Config Descriptor `json:"config"`

specs-go/version.go

@@ -22,7 +22,7 @@ const (
 	// VersionMinor is for functionality in a backwards-compatible manner
 	VersionMinor = 0
 	// VersionPatch is for backwards-compatible bug fixes
-	VersionPatch = 1
+	VersionPatch = 2
 
 	// VersionDev indicates development branch. Releases will be empty string.
 	VersionDev = "-dev"