Azure-sdk-for-python: docs.microsoft.com doesn't document keyword only args.

Created on 3 Mar 2020  路  4Comments  路  Source: Azure/azure-sdk-for-python

IT seems like docs.microsoft.com is not documenting kwargs anywhere.

Here are some examples:

Storage:
https://docs.microsoft.com/en-us/python/api/azure-storage-blob/azure.storage.blob.blobclient?view=azure-python#get-page-ranges-offset-none--length-none--previous-snapshot-diff-none----kwargs-

Keyvault:
https://docs.microsoft.com/en-us/python/api/azure-keyvault-keys/azure.keyvault.keys.keyclient?view=azure-python#list-properties-of-keys---kwargs-

Docs EngSys

Most helpful comment

This PR Resolve this issue!

All 4 comments

@maggiepint @scbedd @kaerm

And here is an example of customer confusion:

Looking at the docs for dowload_blob it's not apparent that it accepts a max_concurrency argument. Is there a better way I could have discovered this?

We have an item filed against the docs team for this. I thought I had an issue filed against this repo to track on our side, but obviously not. Thanks @rakshith91

This PR Resolve this issue!

Was this page helpful?
0 / 5 - 0 ratings