[Verb-led feature title]

[State the result the reader will achieve and the situation in which this feature is appropriate.]

Prerequisites

  • .NET [supported version or versions]
  • [required package]
  • [application or runtime prerequisite]
dotnet add package [Package.Id]

Minimal example

[Complete, focused arrange/act/assert example]

[Explain the calls that determine behavior. Do not narrate self-evident syntax.]

Configure [important behavior]

[Show realistic variants, defaults, and when to choose each option.]

[Verified configuration example]

[Show cross-package composition only when it represents a common workflow.]

Diagnose failures

[Describe the failure boundary, public exception or diagnostic type, stable diagnostic fields, and the corrective action. Include a negative example where useful.]

Limitations and safety

  • [Runtime or emulation boundary]
  • [Lifecycle, cleanup, parallelism, or cancellation constraint]
  • [Security or sensitive-data consideration]
  • [Alternative to use when this feature is not appropriate]
  • Related guide: [replace with a repository-relative link]
  • API reference: [replace with the generated API link]
  • Canonical executable example: [replace with a repository-relative source link]