Skip to content

Commit 83479d4

Browse files
committed
Clean up portability considerations
Also fix typo. Signed-off-by: Jon Johnson <[email protected]>
1 parent fccc435 commit 83479d4

File tree

1 file changed

+2
-3
lines changed

1 file changed

+2
-3
lines changed

descriptor.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ Note that `[A-F]` MUST NOT be used here.
154154
## Embedded Content
155155

156156
In many contexts, such as when downloading content over a network, resolving a descriptor to its content has a measurable fixed "roundtrip" latency cost.
157-
For large blobs, the fixed cost is usually inconsequental, as the majority of time will be spent actually fetching the content.
157+
For large blobs, the fixed cost is usually inconsequential, as the majority of time will be spent actually fetching the content.
158158
For very small blobs, the fixed cost can be quite significant.
159159

160160
Implementations MAY choose to embed small pieces of content directly within a descriptor to avoid roundtrips.
@@ -163,8 +163,7 @@ Implementations MUST NOT populate the `data` field in situations where doing so
163163
For example, a registry MUST NOT arbitrarily populate `data` fields within uploaded manifests, as that would modify the content identifier of those manifests.
164164
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.
165165

166-
Implementations SHOULD consider limitations of storage systems when deciding whether or not to embed data.
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.
166+
Implementations SHOULD consider portability when deciding whether to embed data, as some providers are known to refuse to accept or parse manifests that exceed a certain size.
168167

169168
## Examples
170169

0 commit comments

Comments
 (0)