3 ms·
Microsofts documentation is a mixed bag, but mostly rather good, if you know how to read it. An example of a place where it's bad is the Python API for Azure.
by mrweasel 5y ago
Microsofts documentation is a mixed bag, but mostly rather good, if you know how to read it.
An example of a place where it's bad is the Python API for Azure. I needed to call some service, I forget which, and everything was clearly just translated from C#. There's a function which takes a string as an input, except it doesn't, it takes one of three string, neither of which is mentioned. I assume that in C# it's an enum, and Visual Studio will just list the option for you.
- dragonwriter 5y ago> Microsofts documentation is a mixed bag, but mostly rather good, if you know how to read it. “if you know how to read it” is...not a ringing endorsement of documentation. But, its true that MS documentation is less likely to be wrong once you understand what it is trying to say than, say, Amazon's (though have glaring omissions or things concealed by opaque organization is quite common.)