DEV Community

Discussion on: Clean Code Applied to JavaScript — Part IV. Comments

Collapse
 
rsuttles58 profile image
Rob Suttles

While comments on every line are definitely an eye sore, aren't positional markers a tool to improve readability and grouping of code? I'm admittedly a junior/mid-level dev, but have received complements for the way that I have utilized positional markers in my code/scripts. I want to add that I didn't care for the way the positional markers were styled here but overall I think they improve readability for other users.

Far too often, I see zero commenting in code. If there had to be one extreme or another I would prefer verbose code commenting, particularly in larger development teams where a significant number of junior or developers new to the team will be reviewing code and do not understand business logic and process context.