Last week, in addition to the general availability of all the various 2007 Office System SP1 installs, the SharePoint developer team refreshed MSDN with a lot of updated and new content. The post on the MSFT SharePoint Developer Doc blog sums up all the new stuff. What I was real happy to see was the (1) new content on ASP.NET AJAX, the (2) updated section on building custom field controls, the (3) updated section on mobile control development and the (4) updated info on all classes that are involved in auditing. They also added some valuable best practice papers such as the disposable objects one. For you WCM folks, there wasn't a ton of new stuff specific to Publishing site development aside from the mobile control development and document converters.
The SharePoint documentation guys took quite a bit of heat early on (around RTW in late 2006) by the community at large. Since then the SDK has been a living organism. Those guys have been working real hard at adding & updating content over the last 12 months and it shows. There's a lot that goes into it and just know, there are some great people working very hard on it to give us developers the best experience possible. Don't like something? Instead of bitching about it, do something about it! Then go bitch about it and blog it on your own blog, pointing to your new content. :) Go straight to the page in the SDK on MSDN you think needs to have more content and add it yourself using the community contribution wiki at the bottom of the page! Nothing beats collaborative help! Here's a great example by my bud Randy, the MossMan, who added some extra info to a page he think needed some help.
No word yet on when we'll see updated CHM's available for download. That's the primary way I use the SDKs since the experience is just so much faster and who's got the patience to use that dang Internet thing anyway. :)