It's been a long time since I've looked at Windows documentation, but I wonder if it's reasonable to treat their documentation as the actual contract offered by the OS?

I had the impression that poor documentation forced a lot of Windows programmers to understand Microsoft's API's via experimentation.