Tbf, i always comment my code to do a sanity check of what i am doing along the way( think rubber duck method with comments). The problem is that my writing is so cryptic i am the only one that could ever understand it.

[–] spooky2092@lemmy.blahaj.zone 27 points 1 week ago (5 children)

I have to comment my code because otherwise I have no idea wth I was writing 6mo ago.

Like, I recently had to update a script I wrote 2 years ago and had thought 'this is self explanatory, I don't need to comment it's only to have me come back and have to walk the code to figure out I forgot to include an edge case that hadn't occurred yet ..

[–] Omgpwnies@lemmy.world 12 points 1 week ago (3 children)

Break it up into functions with names that describe what it does, then the script becomes basically a sequence of function calls and is easier to read and troubleshoot.

[–] jkercher@programming.dev 2 points 1 week ago

I'm on your side dude. Comments rot. Some are useless. Don't even get me started on doxygen comments.

load more comments (2 replies)

load more comments (3 replies)

load more comments (9 replies)