Documentation's big flaw is usually that it drifts from the state of the code - that's why commit time is probably the best documentation time! Why don't our tools already gather the commit messages as docs? Because developers don't value their commits!