Skip to content

[Cache] ELI5: Simplify cache-response-rules docs#30663

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

[Cache] ELI5: Simplify cache-response-rules docs#30663
Oxyjun wants to merge 1 commit intoproductionfrom
jun/cache/how-to/cache-response-rules/eli5

Conversation

@Oxyjun
Copy link
Copy Markdown
Contributor

@Oxyjun Oxyjun commented May 7, 2026

Summary

Apply ELI5 analysis to 3 files in docs/cache/how-to/cache-response-rules/. Two files (create-api.mdx, terraform-example.mdx) were skipped as developer-focused API references with no clarity issues.

Changes by file

  • index.mdx: Fix factual error (stripping ETag also disables Smart Edge Revalidation, not just Last-Modified), replace external blog link with internal docs link, clarify phase timing, remove unused OCC abbreviation, fix style (enabled to turned on)
  • create-dashboard.mdx: Add standard login step per style guide convention, simplify conditional phrasing
  • settings.mdx: Bold Edit expression as UI element, replace blog link with internal docs, define cache tags inline, add why context for set_cache_control action, fix enabled to turned on (3 occurrences)

Review notes

Key fix: index.mdx had a factual error — original said only stripping Last-Modified disables Smart Edge Revalidation, but settings.mdx confirms stripping ETag OR Last-Modified disables it.

Apply ELI5 analysis to 3 files (2 skipped as developer-focused API refs):
- index.mdx: Fix factual error (strip ETag also disables Smart Edge Revalidation, not just Last-Modified), replace blog link with internal docs link, clarify phase timing, remove OCC abbreviation
- create-dashboard.mdx: Add standard login step per style guide, simplify step wording
- settings.mdx: Fix Edit expression formatting, replace blog link with internal docs, define cache tags inline, add why context for set_cache_control, fix enabled->turned on
@Oxyjun Oxyjun requested review from a team and dcpena as code owners May 7, 2026 08:28
@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

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