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.

[–] 1984@lemmy.today 8 points 1 week ago* (last edited 1 week ago)

Yeah I dont know why people dont do this. Then an overall description of the script at the top is enough and anyone can just look at function names to see what is going on.

[–] Earflap@reddthat.com 5 points 1 week 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.

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

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