Reflections on 10k Hours of Programming

Re:Reflections on 10k Hours of Programming by juancb on Friday August 06, 2021 @12:33PM (#28089489)

What's your take on the difference between explaining how code works and describing what it does?

I only ask because of bits like the TCP rate estimator sometimes have step by step comments that might be interpreted as explaining how the code is doing something.

For example take the app limited detection function: https://github.com/torvalds/linux/blob/master/net/ipv4/tcp_r...

[ Parent | on HN ]

Re:Reflections on 10k Hours of Programming by mastersummoner on Friday August 06, 2021 @12:42PM (#28089630)

My take is that step by step commented explanations make sense when it's something either extremely complicated or making use of a system or tech that's not widely known.

Otherwise, clearer code, smaller methods and better variable/method names are the way to go imo.

[ Parent | on HN ]