Except when the documentation is out dated and has very little to do with the actual code. At that point you are better off without bad documentation than with

Except when the documentation is out dated and has very little to do with the actual code. At that point you are better off without bad documentation than with it. I've wasted a lot of time solving strange bugs because the API had stayed the same as when the documentation was written, but the implications were totally different.