Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Feb 4, 2026

Plan: Update Caching Documentation with HybridCache

  • Update the introduction section to mention HybridCache as a third caching approach
  • Add a new "HybridCache" section after "Worker Service caching" explaining:
    • What HybridCache is (combines in-memory and distributed caching)
    • Key features (stampede protection, configurable serialization, tag-based invalidation)
    • When to use it
  • Add HybridCache API documentation including:
    • Installation and registration
    • Basic GetOrCreateAsync usage
    • Configuration options
    • Tag-based invalidation
    • Serialization configuration
    • Distributed cache integration
  • Create code examples in ./snippets/caching/hybrid-cache/csharp/ folder
  • Build and test the examples
  • Address code review feedback (add region tags, improve comments)
  • Run security checks (CodeQL - no issues found)
  • Address PR feedback:
    • Target .NET 10 instead of .NET 9
    • Fix grammar (remove comma before "and provides")
    • Fix heading ("Configure" instead of "Configuring")
    • Update package versions to 10.0.0 to match .NET 10 target
  • Final verification and documentation build

Summary

Successfully added comprehensive HybridCache documentation to the .NET caching guide. All feedback addressed. Package versions now align with .NET 10 target framework.

Original prompt

This section details on the original issue you should resolve

<issue_title>Update Caching docs with HybridCache</issue_title>
<issue_description>### Type of issue

Need to update docs to contain HybridCache

Description

Prelim content found here:
https://learn.microsoft.com/en-us/aspnet/core/performance/caching/hybrid?view=aspnetcore-9.0

Page URL

https://learn.microsoft.com/en-us/dotnet/core/extensions/caching

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/extensions/caching.md

Document Version Independent Id

07beacc6-ddcf-2fd5-b896-00f999764b00

Platform Id

97e770aa-0b26-d69d-80e4-578056090645

Article author

@IEvangelist

Metadata

  • ID: ed120c7a-f4c0-c1d1-cb8c-168a3eba6dd9
  • PlatformId: 97e770aa-0b26-d69d-80e4-578056090645
  • Service: dotnet-fundamentals

Related Issues</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.


Internal previews

📄 File 🔗 Preview link
docs/core/extensions/caching.md docs/core/extensions/caching

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI changed the title [WIP] Update caching documentation with HybridCache details Add HybridCache documentation to caching guide Feb 4, 2026
Copilot AI requested a review from gewarren February 4, 2026 02:23
@gewarren
Copy link
Contributor

gewarren commented Feb 4, 2026

@copilot please respond to feedback.

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Feb 4, 2026

@copilot please respond to feedback.

All feedback addressed in commit 207bf9c:

  • Updated project to target .NET 10
  • Fixed grammar in introduction
  • Updated heading to use imperative mood

Copilot AI requested a review from gewarren February 4, 2026 22:25
@gewarren gewarren marked this pull request as ready for review February 4, 2026 23:19
@gewarren gewarren requested a review from a team as a code owner February 4, 2026 23:19
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This pull request adds comprehensive documentation for HybridCache to the .NET caching guide. HybridCache is a new caching library introduced in .NET 9 that combines in-memory and distributed caching with additional features like stampede protection and tag-based invalidation.

Changes:

  • Updated introduction to list HybridCache as a third caching approach alongside in-memory and distributed caching
  • Added complete HybridCache section with subsections covering key features, setup, usage, configuration, tag-based invalidation, and serialization
  • Created code examples demonstrating HybridCache functionality in a new snippets directory
  • Added HybridCache reference link to the "See also" section

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
docs/core/extensions/caching.md Added HybridCache section with comprehensive documentation, updated introduction to mention three caching approaches, and added reference link in "See also"
docs/core/extensions/snippets/caching/hybrid-cache/csharp/Program.cs Created code snippets demonstrating HybridCache registration, configuration, basic usage, tag-based caching, invalidation, serialization, and Redis integration
docs/core/extensions/snippets/caching/hybrid-cache/csharp/HybridCacheExample.csproj Created project file for code examples targeting .NET 10 with necessary package references

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested a review from gewarren February 11, 2026 22:41
@gewarren gewarren enabled auto-merge (squash) February 11, 2026 22:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Caching docs with HybridCache

2 participants