Skip to content

[Cache] ELI5: Simplify cache-rules examples and fix cookie name bug#30666

Open
Oxyjun wants to merge 1 commit intoproductionfrom
jun/cache/how-to/cache-rules-examples/eli5
Open

[Cache] ELI5: Simplify cache-rules examples and fix cookie name bug#30666
Oxyjun wants to merge 1 commit intoproductionfrom
jun/cache/how-to/cache-rules-examples/eli5

Conversation

@Oxyjun
Copy link
Copy Markdown
Contributor

@Oxyjun Oxyjun commented May 7, 2026

Summary

Apply ELI5 analysis to 12 example files in docs/cache/how-to/cache-rules/examples/. 9 files changed, 3 needed no changes.

Key fixes

  • bypass-cache-on-cookie.mdx: Cookie name mismatch — prose said test_cookie (underscore) but Expression Builder/Editor both use test-cookie (hyphen). Fixed to test-cookie.
  • cache-deception-armor.mdx: Added cross-link to the cache deception attacks concept page — the term was used without definition or link.
  • cache-everything.mdx: Fixed misindented admonition closing tag that could cause rendering issues.
  • edge-ttl.mdx: Removed tautological phrasing (edge cache TTL for caching resources on Cloudflare edge).

Consistency fixes across 5 files

  • Fixed description fields that duplicated the title verbatim
  • Normalized list markers (asterisk to dash) for consistency with sibling files
  • Added missing semicolons to import statements

Apply ELI5 analysis to 9 of 12 example files (3 needed no changes):
- bypass-cache-on-cookie.mdx: Fix cookie name mismatch (test_cookie vs test-cookie)
- cache-deception-armor.mdx: Add cross-link to cache deception concept page
- cache-everything.mdx: Fix misindented admonition closing tag
- edge-ttl.mdx: Remove redundant tautology in intro sentence
- browser-cache-ttl, cache-device-type, origin-cache-control, query-string-sort, respect-strong-etags: Fix descriptions repeating titles, normalize list markers and import semicolons
@Oxyjun Oxyjun requested review from a team and dcpena as code owners May 7, 2026 09:37
@github-actions github-actions Bot added size/s product:cache Issues or PRs related to Cache 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

github-actions Bot commented May 7, 2026

Preview URL: https://71543102.preview.developers.cloudflare.com
Preview Branch URL: https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/origin-cache-control/ https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/origin-cache-control/
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/query-string-sort/ https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/query-string-sort/
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/respect-strong-etags/ https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/respect-strong-etags/
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/cache-everything/ https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/cache-everything/
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/bypass-cache-on-cookie/ https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/bypass-cache-on-cookie/
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/cache-deception-armor/ https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/cache-deception-armor/
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/browser-cache-ttl/ https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/browser-cache-ttl/
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/cache-device-type/ https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/cache-device-type/
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/edge-ttl/ https://jun-cache-how-to-cache-rules-examples-eli5.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/edge-ttl/

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants