Skip to content

docs: document async .NET OpenFeature initialization - #996

Merged
jonathannorris merged 2 commits into
mainfrom
docs-async-dotnet-openfeature
Aug 7, 2026
Merged

docs: document async .NET OpenFeature initialization#996
jonathannorris merged 2 commits into
mainfrom
docs-async-dotnet-openfeature

Conversation

@jonathannorris

@jonathannorris jonathannorris commented Aug 7, 2026

Copy link
Copy Markdown
Member

Summary

  • Use SetProviderAsync in the .NET OpenFeature setup example.
  • Document that provider initialization must remain asynchronous.
  • Explain that blocking can deadlock UI and legacy ASP.NET synchronization contexts.

Motivation

The .NET provider waits for Local Bucketing to download its initial configuration. The docs should show the async path and discourage blocking on the returned task.

Validation: yarn docusaurus build

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 7, 2026

Copy link
Copy Markdown

Deploying devcycle-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: c8d548e
Status: ✅  Deploy successful!
Preview URL: https://0bdc68bc.devcycle-docs.pages.dev
Branch Preview URL: https://docs-async-dotnet-openfeatur.devcycle-docs.pages.dev

View logs

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates the .NET OpenFeature Provider documentation to demonstrate correct asynchronous provider initialization, helping readers avoid deadlocks when the provider requires async startup work.

Changes:

  • Switch the setup example to await OpenFeature.Api.Instance.SetProviderAsync(...).
  • Add guidance to keep provider initialization asynchronous and avoid blocking on the returned task.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/sdk/server-side-sdks/dotnet/dotnet-openfeature.md Outdated
@jonathannorris
jonathannorris force-pushed the docs-async-dotnet-openfeature branch from 174b354 to c8d548e Compare August 7, 2026 19:31
@jonathannorris
jonathannorris enabled auto-merge (squash) August 7, 2026 19:31
@jonathannorris
jonathannorris merged commit 5f65f09 into main Aug 7, 2026
5 checks passed
@jonathannorris
jonathannorris deleted the docs-async-dotnet-openfeature branch August 7, 2026 19:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants