[FEATURE REQ] - Add ASP.NET Core example to "Managing the Client Object" documentation

[claudiogodoy99]

Describe the feature or improvement you are requesting

Hi team,

I’d like to suggest enhancing the documentation with a dedicated section on managing the client object, especially clarifying whether it is thread-safe and how it should be instantiated (e.g., singleton vs. transient).

Currently, all examples are in plain C#, but many developers—myself included—work with ASP.NET Core and would benefit from a concrete example that shows how to register and use the client via dependency injection.

A section like “Managing the Client Object in ASP.NET Core” could include:

• Thread-safety guidance
• Singleton registration via IServiceCollection
• Example usage in a controller or service

This would align well with common ASP.NET Core practices and help avoid misuse or performance issues.

Thanks for considering!

this request is related to #473

Additional context

No response

[jsquire]

Hi @claudiogodoy99. Thanks for reaching out and for your suggestion. This is a great idea and definitely a gap at present. We'll look at formalizing this guidance in the near future.

[jsquire]

@achandmsft: We'll need to align on a strategy for documenting general guidance such as this. If we don't have something, we should start thinking about it.

[claudiogodoy99]

@jsquire I'm working on a PoC pull request on this point, I'm planning to finish this weekend!