The author makes an excellent point. Each development team at Microsoft has a dedicated documentation team. The developers typically write the API "xmldoc" lev

The author makes an excellent point. Each development team at Microsoft has a dedicated documentation team. The developers typically write the API "xmldoc" level documentation, but the doc team writes the overviews, examples, etc. They also perform heavy editing and standardization of all documentation materials. I think the docs folks I work with do a stellar job, but I think the docs would be overall better if the developers wrote them and the documentation team simply edited them. This would mean that the developers get less time to write code, but quite honestly, that is might be a good thing. There is a double digit number of windowing toolkits in active use at Microsoft...