Skip to content

Commit d5f627d

Browse files
committed
descriptor: clarify platform and artifacts
Signed-off-by: Bjorn Neergaard <[email protected]>
1 parent f92d83e commit d5f627d

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

descriptor.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,9 @@ The following fields contain the primary properties that constitute a Descriptor
5858
This property MUST be the same as the `artifactType` of the referenced [manifest](manifest.md), or the `mediaType` of the `config` descriptor if an `artifactType` is not set.
5959
If defined, the value 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].
6060

61-
Descriptors pointing to [`application/vnd.oci.image.manifest.v1+json`](manifest.md) SHOULD include the extended field `platform`, see [Image Index Property Descriptions](image-index.md#image-index-property-descriptions) for details.
61+
Descriptors referencing an Image (as defined in the [artifacts guidance](artifacts-guidance.md)) SHOULD include the extended field `platform`.
62+
See [Image Index Property Descriptions](image-index.md#image-index-property-descriptions) for details.
63+
Artifacts as defined in the artifacts guidance MAY include the extended field `platform` when it improves discoverability or interoperability of the artifact.
6264

6365
### Reserved
6466

0 commit comments

Comments
 (0)