DEV Community

Discussion on: Do Code Comments Deserve a Special Spot or Can Well-Written Code Speak for Itself?

Collapse
 
developerwithout profile image
Joshua Dix

Well written code should be able to speak for itself. This is part of clean code.

Collapse
 
ephilips profile image
Eesaa Philips

The guy who wrote Clean Code is a charlatan who never proved to work on high performance, large-scale systems. Some of the stuff he advocates for is true while others are opinionated suggestions he treats as axioms although they were never proven to increase systems' quality.
If you're writing a complex system, you will have to do some complex work that will require comments. Open the source code for tcp in linux, for example; this is well written and it's full of comments: link.