News for hackers. Stuff that matters.
Re:Reducing technical debt by valuing comments as much as code by baby on Wednesday February 01, 2023 @02:10AM (#34607431)
I agree with you. It’s like having too much doc, or doc so outdated it’s harmful. These are fairy tails. I’d take too much doc or outdated doc any time of the day over no doc/comments.
Re:Reducing technical debt by valuing comments as much as code by ahtihn on Wednesday February 01, 2023 @11:04AM (#34612410)
Too much documentation, outdated documentation or just plain wrong documentation leads to people simply ignoring it altogether, even the good parts.
Re:Reducing technical debt by valuing comments as much as code by baby on Wednesday February 01, 2023 @12:04PM (#34613577)
Who cares if they ignore it. The moment where they get stuck on something then they can check the part that refers to that