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 3 weeks 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 11 points 3 weeks 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.

[–] Earflap@reddthat.com 6 points 3 weeks ago

This is how I started writing my scripts and it is sublime. Even better is when your function can be a single return statement, makes writing tests easy.

load more comments (2 replies)

load more comments (3 replies)

load more comments (9 replies)