News for hackers. Stuff that matters.

A comment on Reducing technical debt by valuing comments as much as code. Parent comment

Re:Reducing technical debt by valuing comments as much as code by j45 on Tuesday January 31, 2023 @05:27PM (#34603227)
Comments are critical at creating beginners to the code base, something rarely the expert class think about accelerating.

For my code? I agree

Code for others to participate in? The simplest possible way for the greatest number of developers to understand as quickly as possible. Not about my best practice or preference but for the greater good.

Coding standards for the elite devs are only so effective at growing that growing quick enough.

[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by layer8 on Tuesday January 31, 2023 @06:50PM (#34604118)
The expert will be helped as well when coming back to the code after a few months.
[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by j45 on Wednesday February 01, 2023 @01:04PM (#34614727)
100%.

Comments are a critical way to more quickly re-grok the mental model of what's going on for your future self as well.

I think there was a post in the past few weeks about a single developer who maintained hundreds of his own tools, and for him it came down to process and documentation first so it was easy to come back to months or years later.

[ Parent | on HN ]