• Omgpwnies@lemmy.world
    link
    fedilink
    English
    arrow-up
    11
    ·
    7 days ago

    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
      link
      fedilink
      English
      arrow-up
      1
      ·
      6 days ago

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

    • 1984@lemmy.today
      link
      fedilink
      arrow-up
      8
      ·
      edit-2
      7 days 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.

    • Radioactive Butthole@reddthat.com
      link
      fedilink
      English
      arrow-up
      5
      ·
      7 days 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.