Re:Please, kill your darlings
by mhurron on Tuesday March 08, 2016 @11:32AM
(#11246291)
It's amazing, their whole complaint is solved by proper software development practices - Comment your code.
[ Parent
| on HN ]
Re:Please, kill your darlings
by prodigal_erik on Tuesday March 08, 2016 @12:52PM
(#11247007)
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.