Skip to content

[Cache] ELI5: Simplify edge-browser-cache-ttl docs#30667

Open
Oxyjun wants to merge 1 commit into
productionfrom
jun/cache/how-to/edge-browser-cache-ttl/eli5
Open

[Cache] ELI5: Simplify edge-browser-cache-ttl docs#30667
Oxyjun wants to merge 1 commit into
productionfrom
jun/cache/how-to/edge-browser-cache-ttl/eli5

Conversation

@Oxyjun
Copy link
Copy Markdown
Contributor

@Oxyjun Oxyjun commented May 7, 2026

Summary

Apply ELI5 analysis to 2 files in docs/cache/how-to/edge-browser-cache-ttl/.

Key fix

set-browser-ttl.mdx had a factual conflict: line 23 stated Cache Rule values are ignored when origin max-age is higher, but cache-control.mdx and cdn-cache-control.mdx both state that Browser Cache TTL Cache Rules override max-age. The whichever-is-higher behavior applies to the zone-level setting, not Cache Rules. Fixed to clarify the distinction and direct users to Cache Rules for override behavior.

Other changes

  • index.mdx: Add why context for Edge Cache TTL, fix broken admonition closing tag, remove redundant Note label, fix trailing whitespace
  • set-browser-ttl.mdx: Add missing Expires header to override conditions, fix dashboard login convention, fix drop-down to dropdown, fix inconsistent Browser Cache TTL capitalization

Apply ELI5 analysis to 2 files:
- index.mdx: Add why context for Edge Cache TTL, fix broken admonition closing tag, remove redundant Note label
- set-browser-ttl.mdx: Fix factual conflict (Cache Rule override behavior incorrectly described as zone-level behavior), add missing Expires header to override conditions, fix dashboard login convention, fix inconsistent capitalization
@Oxyjun Oxyjun requested a review from dcpena as a code owner May 7, 2026 09:41
@Oxyjun Oxyjun requested a review from a team May 7, 2026 09:41
@github-actions github-actions Bot added product:cache Issues or PRs related to Cache size/s labels May 7, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cache/ @angelampcosta, @dcpena, @cloudflare/pcx-technical-writing, @cloudflare/product-owners

@github-actions
Copy link
Copy Markdown
Contributor

Hey there, we've marked this pull request as stale because there's no recent activity on it. This label helps us identify PRs that might need updates (or to be closed out by our team if no longer relevant).

@github-actions github-actions Bot added the stale label May 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:cache Issues or PRs related to Cache size/s stale

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants