Skip to content

[Cache] SEO: cache-control header #22270

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 1 commit into
base: production
Choose a base branch
from
Open

[Cache] SEO: cache-control header #22270

wants to merge 1 commit into from

Conversation

ToriLindsay
Copy link
Contributor

Improve https://developers.cloudflare.com/cache/concepts/cache-control/
SEO ranking for keywords:

  • Cache control header
  • Cache-control header
  • Cache control
  • Cache control headers
  • Cache headers
  • Cache-control headers
  • Header cache-control

@github-actions github-actions bot added product:cache Issues or PRs related to Cache product:rules Related to rules product:workers Related to Workers product labels May 7, 2025
@github-actions github-actions bot added the size/s label May 7, 2025
@hyperlint-ai Hyperlint AI
Copy link
Contributor

hyperlint-ai bot commented May 7, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.

PR Change Summary

Enhanced SEO for the Cache-Control header documentation by improving content clarity and adding relevant links.

  • Updated the Cache-Control header documentation to improve SEO ranking for related keywords.
  • Added descriptions and links to relevant sections for better user guidance.
  • Clarified the behavior of Cache-Control directives in various contexts.

Modified Files

  • src/content/docs/cache/advanced-configuration/cache-reserve.mdx
  • src/content/docs/cache/concepts/cache-control.mdx
  • src/content/docs/cache/concepts/cache-responses.mdx
  • src/content/docs/cache/concepts/customize-cache.mdx
  • src/content/docs/cache/concepts/default-cache-behavior.mdx
  • src/content/docs/cache/how-to/cache-rules/examples/cache-ttl-by-status-code.mdx
  • src/content/docs/cache/how-to/cache-rules/settings.mdx
  • src/content/docs/cache/how-to/edge-browser-cache-ttl/index.mdx
  • src/content/docs/cache/how-to/edge-browser-cache-ttl/set-browser-ttl.mdx
  • src/content/docs/rules/reference/page-rules-migration.mdx
  • src/content/docs/workers/reference/how-the-cache-works.mdx
How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

@github-actions GitHub Actions
Copy link
Contributor

github-actions bot commented May 7, 2025

Preview URL: https://7be21bb1.preview.developers.cloudflare.com
Preview Branch URL: https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/cache/concepts/cache-control/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/cache/concepts/cache-control/
https://developers.cloudflare.com/cache/how-to/cache-rules/settings/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/cache/how-to/cache-rules/settings/
https://developers.cloudflare.com/cache/how-to/edge-browser-cache-ttl/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/cache/how-to/edge-browser-cache-ttl/
https://developers.cloudflare.com/cache/how-to/edge-browser-cache-ttl/set-browser-ttl/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/cache/how-to/edge-browser-cache-ttl/set-browser-ttl/
https://developers.cloudflare.com/rules/reference/page-rules-migration/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/rules/reference/page-rules-migration/
https://developers.cloudflare.com/cache/advanced-configuration/cache-reserve/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/cache/advanced-configuration/cache-reserve/
https://developers.cloudflare.com/cache/concepts/cache-responses/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/cache/concepts/cache-responses/
https://developers.cloudflare.com/cache/concepts/customize-cache/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/cache/concepts/customize-cache/
https://developers.cloudflare.com/cache/concepts/default-cache-behavior/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/cache/concepts/default-cache-behavior/
https://developers.cloudflare.com/cache/how-to/cache-rules/examples/cache-ttl-by-status-code/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/cache/how-to/cache-rules/examples/cache-ttl-by-status-code/
https://developers.cloudflare.com/workers/reference/how-the-cache-works/ https://tori-pcx-seo-cache-control-header.preview.developers.cloudflare.com/workers/reference/how-the-cache-works/

angelampcosta
angelampcosta reviewed May 7, 2025
View reviewed changes
src/content/docs/cache/concepts/cache-control.mdx
@@ -86,7 +87,7 @@ The `stale-if-error` directive is ignored if [Always Online](/cache/how-to/alway
Additional directives that influence cache behavior are listed below.

* `no-transform` — Indicates that an intermediary — regardless of whether it implements a cache — must not transform the payload.
* `vary` — Cloudflare does not consider vary values in caching decisions. Nevertheless, vary values are respected when [Vary for images](/cache/advanced-configuration/vary-for-images/) is configured and when the vary header is [`vary: accept-encoding`](/speed/optimization/content/compression/).
* `vary` — Cloudflare does not consider vary values in caching decisions. Nevertheless, vary values are respected when [Vary for images](/cache/advanced-configuration/vary-for-images/) is configured and when the vary `cache-control` header is [`vary: accept-encoding`](/speed/optimization/content/compression/).
Copy link
Contributor

@angelampcosta angelampcosta May 7, 2025 •
edited
Loading

Choose a reason for hiding this comment

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

I don't think vary is a cache-control header.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@angelampcosta angelampcosta angelampcosta left review comments

@GregBrimble GregBrimble Awaiting requested review from GregBrimble GregBrimble is a code owner

@irvinebroque irvinebroque Awaiting requested review from irvinebroque irvinebroque is a code owner

@mikenomitch mikenomitch Awaiting requested review from mikenomitch mikenomitch is a code owner

@WalshyDev WalshyDev Awaiting requested review from WalshyDev WalshyDev is a code owner

@pedrosousa pedrosousa Awaiting requested review from pedrosousa pedrosousa is a code owner

At least 1 approving review is required to merge this pull request.

Assignees

@pedrosousa pedrosousa

@irvinebroque irvinebroque

@mikenomitch mikenomitch

@GregBrimble GregBrimble

@WalshyDev WalshyDev

@angelampcosta angelampcosta

Labels
product:cache Issues or PRs related to Cache product:rules Related to rules product:workers Related to Workers product size/s
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
7 participants
@ToriLindsay @angelampcosta @pedrosousa @irvinebroque @mikenomitch @GregBrimble @WalshyDev