Paul Cornell (VSSDK Documentation Manager) has just announced that like much of the other MSDN content, the Visual Studio SDK documentation is now wiki-enabled. This means that you can append comments/suggestions/gotchas on to the VSSDK help as well as leverage notes from others.

Visual Studio 2005 SDK Version 3 Wiki-documentation