Self-documenting code is one of the biggest documentation myths in the software industry. This view generally conflates documentation with code comments. I’d like to make two arguments in this post:

Code comments have value

Documentation has more value than just explaining how software works

Source: “My Code is Self-Documenting” — Eric Holscher – Surfing in Kansas