Skip to content

docs: migration guide from Microsoft.Extensions.Http.Resilience #520

Description

@thomhurst

Problem

Most ASP.NET Core adopters arrive from Microsoft.Extensions.Http.Resilience (AddStandardResilienceHandler, AddStandardHedgingHandler, AddResilienceHandler), not from raw Polly. Current coverage is one table and two snippets inside docs/docs/polly-migration.md:271-320. Missing:

  • HttpStandardResilienceOptions field-by-field mapping (RateLimiter, TotalRequestTimeout, Retry, CircuitBreaker, AttemptTimeout) with default values side by side.
  • HttpStandardHedgingResilienceOptions and RoutingStrategyBuilder ordered/weighted groups mapped to HttpEndpointSelectionMode.
  • ResilienceHandlerContext and AddResilienceHandler(name, (builder, context) => …) mapped to AddShield((request, serviceProvider) => …).
  • RequestMessageSnapshot semantics versus HttpContentReplayPolicy and unsafe-method replay defaults.
  • ConfigureHttpClientDefaults usage and the handler-rotation caveat.

Proposed fix

  • New page docs/docs/http-resilience-migration.md in the sidebar next to the Polly migration page.
  • Move the HTTP section out of polly-migration.md and cross-link.
  • All snippets validated by Verify-DocSnippets.ps1; README links the page from the HTTP section.

Tests

  • Docs build, snippet compilation, and link check in CI.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationin-progressPicked up by an agent

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions