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
Closed
wants to merge 4 commits into from
Closed

[Cache] SEO: cache-control header #22270

wants to merge 4 commits into from

Conversation

@ToriLindsay
Copy link
Contributor

@ToriLindsay ToriLindsay commented May 7, 2025

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
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
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 Outdated

* `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.

ToriLindsay
ToriLindsay commented May 14, 2025
View reviewed changes
@github-actions
Copy link
Contributor

github-actions bot commented May 14, 2025

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cache/ @angelampcosta, @cloudflare/pcx-technical-writing
/src/content/docs/rules/ @pedrosousa, @cloudflare/pcx-technical-writing
/src/content/docs/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @WalshyDev, @cloudflare/deploy-config, @cloudflare/pcx-technical-writing, @ToriLindsay, @cloudflare/wrangler

ToriLindsay
ToriLindsay commented May 14, 2025
View reviewed changes
@github-actions
Copy link
Contributor

github-actions bot commented May 14, 2025

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /cache/advanced-configuration/cache-reserve/

@github-actions github-actions bot added size/m and removed size/s labels May 14, 2025
@ToriLindsay
Copy link
Contributor Author

ToriLindsay commented May 14, 2025

Reviewed with Angela and need to retract most changes, so I'll be creating a new PR for this.

@github-actions
Copy link
Contributor

github-actions bot commented May 14, 2025

CI run failed: build logs

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

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/m

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