Even if it can sometimes help, I think it is not an excuse for writing bad documentation.