Changelog: Async stale-while-revalidate (Cache)

[tkornhammar]

Summary

New changelog entry for async stale-while-revalidate (Cache)

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.

[elithrar]

/bonk review this changelog using the changelog skill and make suggestions (only) for any improvements required

[ask-bonk]

Good changelog entry overall — clear explanation of the change and its impact. A few items to address:

1. Anchor link likely broken — The link /cache/concepts/cache-control/#stale-while-revalidate points to a heading that does not exist. The relevant heading in cache-control.mdx is ### Revalidation (anchor #revalidation).
2. Existing docs now contradict this changelog — src/content/docs/cache/concepts/cache-control.mdx at line 82 still says: "Currently, stale-while-revalidate blocks on the first request..." along with lines 83-87 explaining the old synchronous behavior. These should be updated in a separate or accompanying PR to reflect the new async behavior, or readers will see conflicting information.
3. Minor style nits inline below.

[ask-bonk]

Review submitted. Here's a summary of the feedback:

Findings:

1. Broken anchor links (2 occurrences) — Both links to /cache/concepts/cache-control/#stale-while-revalidate reference a heading that does not exist. The actual heading is ### Revalidation (anchor #revalidation). Suggested fixes for lines 9 and 26.

2. Contradicting existing documentation — The note at src/content/docs/cache/concepts/cache-control.mdx:82 still states that stale-while-revalidate blocks on the first request — directly contradicting this changelog. An accompanying PR should update that note and the related content in lines 81-87 to reflect the new async behavior.

3. Style nit — Cache status values (UPDATING, HIT, MISS, REVALIDATED) on line 18 should be wrapped in backticks for consistency with how they appear elsewhere in the docs.

github run

[tkornhammar]

/bonk review the added changes for completeness