I'm kind of drifting off the topic of the thread, but conversation is where you find it ...mh wrote:The D3D documentation is a special kind of awesome. I was hugely frustrated by it at first, but as time went on I really came to appreciate all of the useful info in it. And you're right - it does lead to a better understanding of how things work in general, which does help a lot with OpenGL too.
Microsoft excels at documentation like no other company I think has ever existed. It is really shocking to me that the OpenGL peoples (Kronos Group or whatever) and you can actually substitute others names there (Apple's developer documentation is long winded, detailed and explains absolutely nothing. Developing on Apple platforms requires constant Googling with "stackoverflow.com" in the search phrase).
OpenGL's documentation and samples for any version of the API are so bad that "Nehe" tutorials are the standard for figuring out OpenGL and that is like having to learn about Star Trek from a fan page.
OpenGL's documentation is so bad, that I have historically added +"MSDN" to Google queries for OpenGL stuff because OpenGL documentation doesn't even say stuff like like what the default values are for anything and Microsoft's OpenGL documentation does.