So apparently MSDN is updating is documentation table-of-contents.
Now I use the MSDN libraries several times a week, I rairly find it usefull. That isn't because the TOC is bad, but the entire concept of using the TOC to find one document in amongst 3 million just doesn't work.
Once I find a document that is close, then I will sometimes use the TOC find related docs. But from experience, I know that one article by Dino Espisoto will have nothing to do with another articlue by Dino. Unless I'm just looking for interesting reading material.
Part of this has to do with what I'm looking for on MSDN. Typically I'm either looking for documentation on an API, or for the latest article. Now the RSS feed from MSDN does a good job of the latter, and the Search engine on MSDN does a bad job of the former. One search in 5 will return relavent information. From what I've heard from my developer friends, that is normal.
So please, make the search better (and for the record, I've heard Microsoft is), and make the TOC better. I hope it is more usefull that it has been, but I doubt it.
------------------------------------------------------
Since I'm on this topic (griping about MSDN), there is one other improvement I would like to see. Wiki'ize MSDN. Check out www.wikipedia.com if you dont know what I'm talking about.
Basically, allow users, like my self, help update the MSDN documentation. Maybe not all of it, but users should be able to send in small amount of sample code for an API, or give an alternate explanation of a function, give warnings about bugs, etc.
Between a better search engine and wiki, MSDN could be one of the most powerfull documenation centers on the web.
1 comment:
MSDN majorly suffers from information bloat. They try to put too much information in there and it is poorly organized. To add insult to injury, the client that you install is uaully slower to search then using Google to search the online version. Not sure why anyone would buy it, but I guess they throw it in with most of their other development tools and subscriptions.
Post a Comment