Function kwargs not rendering on docs.ms.com

[scbedd]

Boils down to during processing within the sphinx-docfx-yaml extension, we're seeing the following earning when we enable debug output:

Can't get argspec for <class 'function'>: azure.mgmt.storage.v2015_06_15.aio.operations.StorageAccountsOperations.begin_create
Can't get argspec for <class 'function'>: azure.mgmt.storage.v2015_06_15.aio.operations.StorageAccountsOperations.check_name_availability

I know it's firing from extension.py, but I don't have a root cause as to WHY this is yet.

Note that class kwargs aren't having this same problem.

[scbedd]

After spending a bunch more time with this, I believe this issue is at least twofold. Context here is that Johan raised this as a general issue. It both IS and ISN'T a general issue. We definitely do document some function keyword arguments. The problem is we don't seem to be doing it consistently. There also isn't a great way to programatically pull this detail out of the rendered docs.

For the specific issue that Johan raised, like here...

You'll notice that SOME keyword params are rendered. And NONE of the param types are. That's because this doc string is broken in general.

The sphinx itself not being able to parse the doc string for azure-storage-blob. See our own github.io.

I am going to try a couple local sphinx runs. I'm thinking the easy answer will be to replace the " with ', but I'm digging and will submit a PR that resolves this on the packages that I can find that do this.

As for the "only some" function keyword params, I do have another PR that addresses other issues we've found as part of this investigation.