Walkthrough

Docs updated to document cache middleware default/behavior changes (Cache-Control emission, Expiration 5m, MaxBytes 1 MiB, Age header, key redaction), CORS config types changed to string slices, and public API signature changes for Router.Add and Test.

Changes

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

• Mixed docs and public API/type changes across middleware, router, and test APIs.
• Areas needing attention:
  • Cache config renames (Store → Storage, Key → KeyGenerator) and default behavior differences.
  • CORS config type changes requiring call-site updates.
  • Router.Add and Test signature changes and any impacted call sites or examples.

Possibly related PRs

• 📒 docs: update cache migration guidance #3908 — Very similar cache migration docs and matching public API changes.
• 🧹 chore: Improve Cache middleware defaults #3740 — Overlapping cache middleware defaults (DisableCacheControl, Expiration, MaxBytes) and behavior updates.
• 🧹 chore: Improve cache middleware RFC compliance #3488 — Related cache TTL/Max-Age and RFC Age header handling changes.

Suggested labels

🧹 Updates

Suggested reviewers

• gaby
• sixcolors
• efectn

Poem

🐇 I hopped through changelogs, nibbling bits of code,
Cache rules set to five minutes on the road,
CORS now lists its origins in a row,
Routes learned new signatures — watch them go!
🥕✨

Pre-merge checks and finishing touches

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

Summary of Changes

Hello @ReneWerner87, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request refines the project's documentation by reorganizing and enhancing the guidance for cache middleware. It ensures that users have clear instructions for migrating to new cache behaviors and understanding the updated defaults, improving the overall clarity and usability of the documentation.

Highlights

• Documentation Update: Migration guidance for cache-related changes has been updated and restructured within the documentation.
• Cache Migration Notes Relocation: Inline cache migration notes have been removed from the main 'Cache' section and moved to the dedicated migration guide.
• V2 Cache Behavior Restoration: Detailed steps have been added to the migration guide explaining how to restore v2 Cache-Control behavior, expiration defaults, and cache size limits.
• New Cache Defaults Noted: The documentation now explicitly mentions the new default behaviors for the cache middleware, including automatic Cache-Control headers, increased default Expiration to 5 minutes, and a new MaxBytes limit of 1 MB.