2 ms·
Conversely, when looking through the Azure documentation last week for much of their Python SDK libraries... it's a joke. They have _tonnes_ of new-user intro
by justinclift 5y ago
Conversely, when looking through the Azure documentation last week for much of their Python SDK libraries... it's a joke.
They have _tonnes_ of new-user intro stuff and similar. Super impressive at first look, but once you're past that and need to dig into complicated things it's all undocumented.
Even most of the auto-generated pages in their Python SDK function lists are just "Header -> empty space where content should be -> footer". And nothing else.
... and lets not get started on the docs for Microsoft Graph. :/
- GordonS 5y agoI'm a heavy user of Azure, and I have 2 general issues with their docs. Firstly the documentation for the various SDK is often an issue, because it's often behind the latest release of the SDK. For .NET libraries especially, there is just so much churn that they obviously struggle to keep the docs updated. And then secondly, as you say, there just aren't enough examples beyond the most trivial.