Require IANA mediaType for image config.mediaType and layers.mediaType

imjasonh · imjasonh · commit 336b02c927c7 · 2023-02-03T20:52:41.000-05:00
Signed-off-by: Jason Hall &lt;jason@chainguard.dev&gt;
diff --git a/manifest.md b/manifest.md
@@ -40,6 +40,8 @@ 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.
 
+        If the manifest uses a different media type than the above, it MUST comply with [RFC 6838][rfc6838], including the [naming requirements in its section 4.2][rfc6838-s4.2], and MAY be registered with [IANA][iana].
+
 - **`layers`** *array of objects*
 
     Each item in the array MUST be a [descriptor](descriptor.md).
@@ -65,6 +67,8 @@ Unlike the [image index](image-index.md), which contains information about a set
 
         Entries in this field will frequently use the `+gzip` types.
 
+        If the manifest uses a different media type than the above, it MUST comply with [RFC 6838][rfc6838], including the [naming requirements in its section 4.2][rfc6838-s4.2], and MAY be registered with [IANA][iana].
+
 - **`subject`** *[descriptor](descriptor.md)*
 
     This OPTIONAL property specifies a [descriptor](descriptor.md) of another manifest.
@@ -117,3 +121,7 @@ Unlike the [image index](image-index.md), which contains information about a set
   }
 }
 ```
+
+[iana]:         https://www.iana.org/assignments/media-types/media-types.xhtml
+[rfc6838]:      https://tools.ietf.org/html/rfc6838
+[rfc6838-s4.2]: https://tools.ietf.org/html/rfc6838#section-4.2
