Miro Adamy has a blog entry on the shortcomings of the .NET Framework class library documentation on MSDN. See the posting and comments here: MSDN Documentation - the worst in class ? As it turns out, solutions to the majority of the design complaints are in the process of being addressed; if not for the 2008 release, then for the next one.