Skip to content

[Cache] ELI5: Simplify purge-cache docs#30668

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

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

Conversation

@Oxyjun
Copy link
Copy Markdown
Contributor

@Oxyjun Oxyjun commented May 7, 2026

Summary

Apply ELI5 analysis to 8 of 9 files in docs/cache/how-to/purge-cache/ (purge-varied-images.mdx needed no changes).

Changes by file

  • index.mdx: Define token bucket rate limiting inline, fix edge servers jargon in description
  • purge_by_prefix.mdx: Fix broken pronoun reference, replace ampersand with and, convert question heading to declarative, fix Tiered Cache capitalization
  • purge-by-hostname.mdx: Fix Tiered Cache capitalization, clarify contradictory input format instructions (one per line vs comma-separated)
  • purge-by-single-file.mdx: Fix extra parentheses wrapping a link, replace vague step 5 instruction
  • purge-by-tags.mdx: Fix first person (our to the/Cloudflare), remove etc., rename informal heading to Cache-tag requirements
  • purge-cache-key.mdx: Add cache key definition and cross-link on first use, remove directional language
  • purge-everything.mdx: Add when-to-use context (major redesign, security incident)
  • purge-zone-versions.mdx: Fix first person, convert Step N heading format, remove redundant First, specify GET method

Apply ELI5 analysis to 8 of 9 purge-cache files:
- index.mdx: Define token bucket rate limiting inline, fix description jargon
- purge_by_prefix.mdx: Fix broken pronoun, ampersand, question heading, product name capitalization
- purge-by-hostname.mdx: Fix Tiered Cache capitalization, clarify contradictory input format instructions
- purge-by-single-file.mdx: Fix extra parentheses in link, replace vague step instruction
- purge-by-tags.mdx: Fix first person (our), remove etc., rename informal heading
- purge-cache-key.mdx: Add cache key definition and cross-link, fix directional language
- purge-everything.mdx: Add when-to-use context for purge everything
- purge-zone-versions.mdx: Fix first person, heading format, redundant First
@Oxyjun Oxyjun requested review from a team and dcpena as code owners May 7, 2026 09:47
@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

github-actions Bot commented May 7, 2026

Preview URL: https://4690e058.preview.developers.cloudflare.com
Preview Branch URL: https://jun-cache-how-to-purge-cache-eli5.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/cache/how-to/purge-cache/purge-by-tags/ https://jun-cache-how-to-purge-cache-eli5.preview.developers.cloudflare.com/cache/how-to/purge-cache/purge-by-tags/
https://developers.cloudflare.com/cache/how-to/purge-cache/purge-zone-versions/ https://jun-cache-how-to-purge-cache-eli5.preview.developers.cloudflare.com/cache/how-to/purge-cache/purge-zone-versions/
https://developers.cloudflare.com/cache/how-to/purge-cache/purge_by_prefix/ https://jun-cache-how-to-purge-cache-eli5.preview.developers.cloudflare.com/cache/how-to/purge-cache/purge_by_prefix/
https://developers.cloudflare.com/cache/how-to/purge-cache/purge-cache-key/ https://jun-cache-how-to-purge-cache-eli5.preview.developers.cloudflare.com/cache/how-to/purge-cache/purge-cache-key/
https://developers.cloudflare.com/cache/how-to/purge-cache/purge-by-hostname/ https://jun-cache-how-to-purge-cache-eli5.preview.developers.cloudflare.com/cache/how-to/purge-cache/purge-by-hostname/
https://developers.cloudflare.com/cache/how-to/purge-cache/ https://jun-cache-how-to-purge-cache-eli5.preview.developers.cloudflare.com/cache/how-to/purge-cache/
https://developers.cloudflare.com/cache/how-to/purge-cache/purge-by-single-file/ https://jun-cache-how-to-purge-cache-eli5.preview.developers.cloudflare.com/cache/how-to/purge-cache/purge-by-single-file/
https://developers.cloudflare.com/cache/how-to/purge-cache/purge-everything/ https://jun-cache-how-to-purge-cache-eli5.preview.developers.cloudflare.com/cache/how-to/purge-cache/purge-everything/

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