In most cases, even though there's verbose variable names you still can't understand the why just by reading the code. And even if you did, why would one want to?
Most often I'm just skimming through, and actual descriptions are much better than having to read the code itself.
This whole notion of "documentation can get out of sync with the code, so it's better not to write it at all" is so nonsensical.
Why isn't the solution simply: "lets update the docs when we update the code". Is this so unfathomably hard to do?
Most often I'm just skimming through, and actual descriptions are much better than having to read the code itself.
This whole notion of "documentation can get out of sync with the code, so it's better not to write it at all" is so nonsensical.
Why isn't the solution simply: "lets update the docs when we update the code". Is this so unfathomably hard to do?