I think of this is answering the questions of what vs why. When what is being done is self-evident, that's readable code. When why it's being done is evident, t

I think of this is answering the questions of what vs why. When what is being done is self-evident, that's readable code. When why it's being done is evident, that's good documentation. And, you need both.