Marcus Zarra wrote an article about not trusting documentation. It is based on the point that you are a lousy programmer compared to what you are going to be in the future. Therefore your documentation right now will suck for yourself in the future (and of course other people).