The ideal is code that explains itself, that is for sure.

Because documentation is another point of change and management.

This is simply the DRY principle.

Experienced developers know that documentation becomes another thing that must be maintained and drifts from the thing it is describing. Just like tests.