You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: descriptor.md
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -159,8 +159,9 @@ For very small blobs, the fixed cost can be quite significant.
159
159
160
160
Implementations MAY choose to embed small pieces of content directly within a descriptor to avoid roundtrips.
161
161
162
-
Implementations SHOULD NOT populate the `data` field in situations where doing so would unexpectedly modify content identifiers.
163
-
For example, a registry SHOULD NOT arbitrarily populate `data` fields within uploaded manifests, as that would modify the content address of those manifests.
162
+
Implementations MUST NOT populate the `data` field in situations where doing so would modify existing content identifiers.
163
+
For example, a registry MUST NOT arbitrarily populate `data` fields within uploaded manifests, as that would modify the content identifier of those manifests.
164
+
In contrast, a client MAY populate the `data` field before uploading a manifest, because the manifest would not yet have a content identifier in the registry.
164
165
165
166
Implementations SHOULD consider limitations of storage systems when deciding whether or not to embed data.
166
167
Many implementations will refuse to accept or parse manifests that violate the limitations of their storage systems, so descriptors concerned with portability SHOULD avoid embedding large amounts of data.
0 commit comments