Update messaging for Workers Static Assets bucketing strategy (#21788)

WillTaylorDev · web-flow · commit 3dd73d7d96aa · 2025-04-17T10:29:14.000-04:00
diff --git a/src/content/docs/workers/static-assets/direct-upload.mdx b/src/content/docs/workers/static-assets/direct-upload.mdx
@@ -114,7 +114,7 @@ curl -X POST https://api.cloudflare.com/client/v4/accounts/{account_id}/workers/
 
 The resulting response will contain a JWT, which provides authentication during file upload. The JWT is valid for one hour.
 
-In addition to the JWT, the response instructs users how to optimally batch upload their files. These instructions are encoded in the `buckets` field. Each array in `buckets` contains a list of file hashes which should be uploaded together. Hashes of files that have been recently uploaded may not be returned in the API response; they do not need to be re-uploaded.
+In addition to the JWT, the response instructs users how to optimally batch upload their files. These instructions are encoded in the `buckets` field. Each array in `buckets` contains a list of file hashes which should be uploaded together. Unmodified files will not be returned in the `buckets` field (as they do not need to be re-uploaded) if they have recently been uploaded in previous versions of your Worker.
 
 ```json
 {

Original file line number	Diff line number	Diff line change
`@@ -114,7 +114,7 @@ curl -X POST https://api.cloudflare.com/client/v4/accounts/{account_id}/workers/`
`114`	`114`
`115`	`115`	`The resulting response will contain a JWT, which provides authentication during file upload. The JWT is valid for one hour.`
`116`	`116`
`117`		-In addition to the JWT, the response instructs users how to optimally batch upload their files. These instructions are encoded in the `buckets` field. Each array in `buckets` contains a list of file hashes which should be uploaded together. Hashes of files that have been recently uploaded may not be returned in the API response; they do not need to be re-uploaded.
	`117`	+In addition to the JWT, the response instructs users how to optimally batch upload their files. These instructions are encoded in the `buckets` field. Each array in `buckets` contains a list of file hashes which should be uploaded together. Unmodified files will not be returned in the `buckets` field (as they do not need to be re-uploaded) if they have recently been uploaded in previous versions of your Worker.
`118`	`118`
`119`	`119`	```json
`120`	`120`	`{`