"Does it? You can just alter the code and forget to alter the documentation above the functions/methods" Yes you can forget, but the barrier is much, much, muc

"Does it? You can just alter the code and forget to alter the documentation above the functions/methods" Yes you can forget, but the barrier is much, much, much lower than having to modify a document god knows where.