Skip to content

docs(cache): add Cache Response Rules documentation#28725

Merged
patriciasantaana merged 3 commits intocloudflare:productionfrom
tkornhammar:tim/docs-new-cache-response-rules
Mar 25, 2026
Merged

docs(cache): add Cache Response Rules documentation#28725
patriciasantaana merged 3 commits intocloudflare:productionfrom
tkornhammar:tim/docs-new-cache-response-rules

Conversation

@tkornhammar
Copy link
Copy Markdown
Contributor

@tkornhammar tkornhammar commented Mar 3, 2026 •
edited
Loading

Summary

Add new Cache Response Rules how-to section covering the http_response_cache_settings phase, including:

  • Overview and concept page with availability and troubleshooting
  • Available settings reference (fields, operators, actions)
  • API creation guide with examples for all three actions
  • Dashboard creation guide
  • Terraform example

Referenced changelog: #28986

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.

@tkornhammar tkornhammar requested review from a team and angelampcosta as code owners March 3, 2026 05:54
@github-actions github-actions Bot added product:cache Issues or PRs related to Cache size/l labels Mar 3, 2026
@tkornhammar
Copy link
Copy Markdown
Contributor Author

tkornhammar commented Mar 3, 2026

Uploaded PR for review, hold off merging.

@tkornhammar tkornhammar force-pushed the tim/docs-new-cache-response-rules branch from d715dcc to c25abd5 Compare March 13, 2026 22:48
anthocf
anthocf reviewed Mar 15, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@anthocf anthocf left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall the documentation is looking great! Thanks for working on this.

Comment thread src/content/docs/cache/how-to/cache-response-rules/create-api.mdx Outdated
Comment thread src/content/docs/cache/how-to/cache-response-rules/create-api.mdx Outdated
Comment thread src/content/docs/cache/how-to/cache-response-rules/create-dashboard.mdx
Comment thread src/content/docs/cache/how-to/cache-response-rules/index.mdx Outdated
Comment thread src/content/docs/cache/how-to/cache-response-rules/index.mdx Outdated
Comment thread src/content/docs/cache/how-to/cache-response-rules/settings.mdx Outdated
Comment thread src/content/docs/cache/how-to/cache-response-rules/settings.mdx Outdated
Comment thread src/content/docs/cache/how-to/cache-response-rules/settings.mdx Outdated
Comment thread src/content/docs/cache/how-to/cache-response-rules/settings.mdx
@tkornhammar tkornhammar force-pushed the tim/docs-new-cache-response-rules branch from c25abd5 to 0c81a13 Compare March 16, 2026 15:47
@tkornhammar tkornhammar mentioned this pull request Mar 16, 2026
Merged
2 tasks
Oxyjun
Oxyjun reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/index.mdx Outdated
Oxyjun
Oxyjun reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/settings.mdx Outdated
pedrosousa
pedrosousa reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/create-api.mdx Outdated
pedrosousa
pedrosousa reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/create-api.mdx Outdated
pedrosousa
pedrosousa reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/create-api.mdx Outdated
pedrosousa
pedrosousa reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/create-api.mdx Outdated
pedrosousa
pedrosousa reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/create-api.mdx Outdated
pedrosousa
pedrosousa reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/create-api.mdx Outdated
pedrosousa
pedrosousa reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/create-api.mdx Outdated
pedrosousa
pedrosousa reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/index.mdx Outdated
pedrosousa
pedrosousa reviewed Mar 16, 2026
View reviewed changes
Comment thread src/content/docs/cache/how-to/cache-response-rules/settings.mdx
@tkornhammar
Copy link
Copy Markdown
Contributor Author

tkornhammar commented Mar 17, 2026

Thanks for reviewing, we'll hold off on merging for now until we've updated some things.

@tkornhammar tkornhammar force-pushed the tim/docs-new-cache-response-rules branch 3 times, most recently from 9a2330e to 96e008b Compare March 24, 2026 22:19
@tkornhammar
docs(cache): add Cache Response Rules documentation
8de2e34 
Add new Cache Response Rules how-to section covering the
http_response_cache_settings phase, including:
- Overview and concept page with availability and troubleshooting
- Available settings reference (fields, operators, actions)
- API creation guide with examples for all three actions
- Dashboard creation guide
- Terraform example
@tkornhammar tkornhammar force-pushed the tim/docs-new-cache-response-rules branch from 96e008b to 7b06c57 Compare March 24, 2026 22:28
@tkornhammar tkornhammar force-pushed the tim/docs-new-cache-response-rules branch from 7b06c57 to d61118a Compare March 24, 2026 22:38
@tkornhammar
Copy link
Copy Markdown
Contributor Author

tkornhammar commented Mar 24, 2026

Can this please be merged?

@patriciasantaana patriciasantaana enabled auto-merge (squash) March 24, 2026 23:01
auto-merge was automatically disabled March 25, 2026 02:23

Head branch was pushed to by a user without write access

@patriciasantaana patriciasantaana merged commit 55e5069 into cloudflare:production Mar 25, 2026
7 checks passed
@tkornhammar tkornhammar deleted the tim/docs-new-cache-response-rules branch March 25, 2026 02:55
@tkornhammar tkornhammar restored the tim/docs-new-cache-response-rules branch April 2, 2026 05:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@pedrosousa pedrosousa pedrosousa left review comments

@Oxyjun Oxyjun Oxyjun approved these changes

@angelampcosta angelampcosta Awaiting requested review from angelampcosta

+1 more reviewer

@anthocf anthocf anthocf left review comments

Reviewers whose approvals may not affect merge requirements

Assignees

@angelampcosta angelampcosta

Labels

product:cache Issues or PRs related to Cache size/l

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

6 participants

@tkornhammar @pedrosousa @anthocf @Oxyjun @angelampcosta @patriciasantaana