Perhaps I will be surprised, though.
Perhaps I will be surprised, though.
It's actually kind of sad, because the company burns thousands of man years writing API docs for things no one actually uses. It's certainly not the only reason, but it's another factor in why they ship so infrequently.
If a programmer told you that if skipping documenting the source code would allow it to be delivered sooner, would you buy it? What's next? Skipping tests?
In my projects my team routinely generates not only API documentation, but also unit-tests from comments. This way, if the docs are wrong, the tests fail.
MS must specify what happens in all conditions on all potential configurations of all their systems. I need to look it up but I think its like 50K plus pages of non API docs.