Hacker News new | ask | show | jobs
by mhurron 3752 days ago
It's amazing, their whole complaint is solved by proper software development practices - Comment your code.
2 comments

Code that's clear enough not to need a comment is better than code that has a comment. Comments can be outdated or mistaken and they consume screen real estate.
You still need to document intent. No code is self documenting.
In some cases, naming may be sufficient to communicate intent.
To be fair: What is proper practice, is far from what is common practice