That's a clever way of perpetuating vendor lock-in: write shitty documentation that is still helpful for application developers but also simultaneously makes life VERY hard for interop layer developers (like the WINE project).

Perhaps Microsoft's recent move towards open source might might thinks easier - as far as I can tell there are far too many copyright issues with the _entirety_ of the windows source code for a complete open sourcing there, but they could perhaps open up core parts of the codebase.

Imagine Microsoft engineers contributing to wine also. Perhaps I am dreaming :)