DEV Community

Code comments are a sign that something's off

Alex Bunardzic on October 29, 2020

Often when we write a block of code, we feel the need to supply an accompanying comment. Some teams value code comments, and insist on leaving as m...
Collapse
 
mcsee profile image
Maxi Contieri

Wow !

I wanted to read an article like that for such a long time !!

It remainds me on Naur's paper on Theory Building

Collapse
 
alexbunardzic profile image
Alex Bunardzic

Thank you Maxi. The tragedy of the current state of software engineering lies in the stubborn refusal to admit the staggering level of uncertainty any software project is faced with. We still insist that software engineering is basically no different than traditional forms of engineering -- electrical, civic, etc. In the traditional engineering, we are faced with much lower levels of uncertainty, which enables us to successfully implement quality products by following the Big Plan Upfront.

Such approach always fails miserably in software, and yet we see, today in the year 2020, that majority of teams still fall for this trap of gap thinking.