“My Code is Self-Documenting”

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