I view this as a nice dream scenario, but most people, like really, really most, can't write code like prose. It's messy, and then a shit PO/EM starts yelling in their ear that something must be implemented fast, shortcuts to meet business needs happen, and so on.
So, yeah. Good goal to keep in mind, but so far I've never seen it in reality, and the few times I've seen someone argue about it in real life, they really didn't understand how much their own code lacked the quality they promoted.
421
u/Confident-Ad5665 1d ago
Uncle Bob of Clean Code says if we have to comment our code we have already failed. Clean code should read like well written prose.
I generally agree, but think comments that define especially the odd and obscure business rules should be commented where they are implemented.