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 ed-209 on Tuesday January 31, 2023 @04:22PM (#34602363)
Small, well named functions have served me well in this regard, eg.

if (theWhy()){ theWhat() }

[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by davidw on Tuesday January 31, 2023 @10:12PM (#34605845)
Sounds good in theory. In practice, you get stuff like https://github.com/git/git/blob/master/cache-tree.c#L246
[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by sethaurus on Wednesday February 01, 2023 @01:45AM (#34607274)
I can't tell what's wrong with that — could you elaborate?
[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by davidw on Wednesday February 01, 2023 @10:00AM (#34611362)
It's fine. but it's not exactly small, either. It does a lot of different things.
[ Parent | on HN ]
Re:Reducing technical debt by valuing comments as much as code by machiaweliczny on Wednesday February 01, 2023 @10:18AM (#34611628)
This is something many people don’t do. They just put some weird statements that will change with time and deciphering what they meant is pain
[ Parent | on HN ]