Skip to content

[Brainstorm] Make advanced kwargs discoverable #12122

Closed

Description

See #12102 , no-one can guess what kwargs are available just looking at the doc.

We have the content already:
https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies

How do we make it available for each client? A "aka.ms/options" in all client docstring? Else?

One thing for sure is I don't want to hard-code it, especially since most of these options depends on the version of azure-core, so hard-coding the code makes no sense since the availability will be dependent on the version of installed azure-core, not the installed actual service package.

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

Metadata

Labels

Azure.CoreClientThis issue points to a problem in the data-plane of the library.DocsP0

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions