Skip to content

Conversation

@simon-says
Copy link
Contributor

Clarifying current stale-while-revalidate behaviour

Clarifying current stale-while-revalidate behaviour
@simon-says simon-says requested review from a team and angelampcosta as code owners July 14, 2025 09:59
@github-actions github-actions bot added the product:cache Issues or PRs related to Cache label Jul 14, 2025
@hyperlint-ai
Copy link
Contributor

hyperlint-ai bot commented Jul 14, 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

Clarified the behavior of the stale-while-revalidate directive in the cache-control documentation.

  • Added a warning about the current behavior of stale-while-revalidate blocking on the first request to a stale cache item.
  • Specified that other requests during this process will receive a stale response with an UPDATING status.
  • Provided a reference to the Revalidation and request collapsing guide for further details.

Modified Files

  • src/content/docs/cache/concepts/cache-control.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.

@angelampcosta angelampcosta merged commit 4376835 into cloudflare:production Jul 23, 2025
2 checks passed
@workers-devprod workers-devprod added the contribution [Holopin] Recognizes a docs contribution, big or small label Jul 23, 2025
@holopin-bot
Copy link

holopin-bot bot commented Jul 23, 2025

Congratulations @simon-says, the maintainer of this repository has issued you a holobyte! Here it is: https://holopin.io/holobyte/cmdg6w8ds346707k23w01mf6m

This badge can only be claimed by you, so make sure that your GitHub account is linked to your Holopin account. You can manage those preferences here: https://holopin.io/account.
Or if you're new to Holopin, you can simply sign up with GitHub, which will do the trick!

sdnts pushed a commit to sdnts/cloudflare-docs that referenced this pull request Jul 24, 2025
* Update cache-control.mdx

Clarifying current stale-while-revalidate behaviour

* Update src/content/docs/cache/concepts/cache-control.mdx

* Update src/content/docs/cache/concepts/cache-control.mdx

---------

Co-authored-by: angelampcosta <[email protected]>
thomasgauvin pushed a commit that referenced this pull request Aug 15, 2025
* Update cache-control.mdx

Clarifying current stale-while-revalidate behaviour

* Update src/content/docs/cache/concepts/cache-control.mdx

* Update src/content/docs/cache/concepts/cache-control.mdx

---------

Co-authored-by: angelampcosta <[email protected]>
@simon-says simon-says deleted the patch-5 branch September 9, 2025 14:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution [Holopin] Recognizes a docs contribution, big or small product:cache Issues or PRs related to Cache size/xs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants