I believe Jim has some good points. Being as I have started out, and only been working with the Win XP version so far, I see lots of places where the documentation tries to explain multiple platforms at once.

For instance, the documentation has many references to using qmake or QT += sql or QT += opengl. If you're using Win XP, you don't ever need to touch the qmake tool or edit the .pro file. To even talk about it can be misleading to the Windows programmer; he may try to edit the .pro file, not knowing that the VS integration mostly handles all that stuff already.

It would be nice to know about the gotchas and pitfalls of using the VS integration though - while it has been very easy to use, the documentation for it has been fairly scant, so you have to rely on a lot of programmer's intuition.

It would be nice to have specific sections for platform-specific details of Qt. Or maybe I just haven't found those sections yet.