Skip to content

[Cache] ELI5: Simplify how-to root-level docs#30639

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

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

Conversation

@Oxyjun
Copy link
Copy Markdown
Contributor

@Oxyjun Oxyjun commented May 6, 2026

Summary

Apply ELI5 analysis to 6 root-level files in docs/cache/how-to/. Add missing context, define jargon inline, fix style guide violations.

Changes by file

  • index.mdx: Replace vague intro with concrete description
  • always-online.mdx: Add value statement, fix enable to turn on, add dashboard login convention
  • cache-keys.mdx: Define cache key and cache sharding inline, explain CORS Origin header
  • configure-cache-status-code.mdx: Add opening context, fix Cache-Control formatting
  • set-caching-levels.mdx: Define query strings, fix heading case
  • tiered-cache.mdx: Value-first opening explaining the problem it solves

Apply ELI5 analysis to improve readability across 6 root-level files:
- index.mdx: Replace vague intro with concrete description of child pages
- always-online.mdx: Add value statement, fix enable->turn on, add dashboard login convention, explain why dynamic content fails offline
- cache-keys.mdx: Define cache key and cache sharding inline, explain why Origin header is included (CORS), improve formatting
- configure-cache-status-code.mdx: Add opening context explaining feature purpose, fix Cache-Control from bold to monospace
- set-caching-levels.mdx: Define query strings before using the term, fix heading case and tense
- tiered-cache.mdx: Add value-first opening explaining the benefit before the mechanism
@Oxyjun Oxyjun requested review from a team and dcpena as code owners May 6, 2026 15:56
@github-actions github-actions Bot added product:cache Issues or PRs related to Cache size/s labels May 6, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 6, 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