undefined | Better HN

0 pointsmattacular4y ago0 comments

I guess I have been lucky but I don't really get this. You read comments along with the actual code right? They complement one another. An out of date comment should not ipso facto render code indecipherable and if it does that speaks to a bigger problem with the code itself.

I find it strange that people want to throw the baby out with the bathwater when it comes to commenting code just cause they've been bit before.

0 comments

emodendroket4y ago

You don’t see how you could end up wasting time when a comment led to you making an incorrect assumption? If they don’t affect how you read the code would mean they’re useless.

mattacularOP4y ago

I can see how it could, in theory, if the code is extremely complicated and then the comments are lying to you on top. Again I have never experienced this or anything even close to it in 1.5 decades of coding on teams. Unless every comment is wrong then some of them are useful to someone.

On the other hand, I have been bit plenty of times by incorrect documentation outside of code about libraries and APIs.

emodendroket4y ago

Well, consider that such documentation is often generated from comments.

1 more reply

j / k navigate · click thread line to collapse

0 pointsmattacular4y ago0 comments

I find it strange that people want to throw the baby out with the bathwater when it comes to commenting code just cause they've been bit before.

0 comments

emodendroket4y ago

You don’t see how you could end up wasting time when a comment led to you making an incorrect assumption? If they don’t affect how you read the code would mean they’re useless.

mattacularOP4y ago

On the other hand, I have been bit plenty of times by incorrect documentation outside of code about libraries and APIs.

emodendroket4y ago

Well, consider that such documentation is often generated from comments.

1 more reply

j / k navigate · click thread line to collapse