From 327c837b627d47adb9502c2ad47ec483834e7438 Mon Sep 17 00:00:00 2001 From: James Sturtevant Date: Fri, 6 Oct 2023 18:42:06 +0000 Subject: [PATCH] Add clarifaction for WASM usecase Signed-off-by: James Sturtevant --- artifacts-guidance.md | 4 ++-- manifest.md | 2 ++ 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/artifacts-guidance.md b/artifacts-guidance.md index 49b8c634e..7a358003d 100644 --- a/artifacts-guidance.md +++ b/artifacts-guidance.md @@ -1,6 +1,6 @@ # Guidance for Artifacts Authors Content other than OCI container images MAY be packaged using the image manifest. -When this is done, the `config.mediaType` value should not be a known OCI image config [media type](media-types.md). -Historically, due to registry limitations, some tools have created non-OCI conformant artifacts using the `application/vnd.oci.image.config.v1+json` value for `config.mediaType` and values specific to the artifact in `layer[*].mediaType`. +When this is done, the `config.mediaType` value MAY not be a known OCI image config [media type](media-types.md). +Historically, due to registry limitations, some tools have created non-OCI conformant artifacts using the `application/vnd.oci.image.config.v1+json` value for `config.mediaType` and values specific to the artifact in `layer[*].mediaType`. In some cases, the `application/vnd.oci.image.config.v1+json` may still be appropriate if the artifact is to be run via a runtime. Implementation details and examples are provided in the [image manifest specification](manifest.md#guidelines-for-artifact-usage). diff --git a/manifest.md b/manifest.md index 983941612..c6ac9ba78 100644 --- a/manifest.md +++ b/manifest.md @@ -255,6 +255,8 @@ The decision tree below and the associated examples MAY be used to design new ar } ``` + In the case where the artifact may be run by a runtime the `config.mediaType` MAY be `application/vnd.oci.image.config.v1+json`. + _Implementers note:_ artifacts have historically been created without an `artifactType` field, and tooling to work with artifacts should fallback to the `config.mediaType` value. [iana]: https://www.iana.org/assignments/media-types/media-types.xhtml