• xmunk@sh.itjust.works
    link
    fedilink
    arrow-up
    4
    ·
    4 hours ago

    Not everything needs a comment - knowing when comments add value is the key… “what” vs “why” is usually a good indicator but some code just doesn’t need a comment.

    • darklamer@lemmy.dbzer0.com
      link
      fedilink
      arrow-up
      1
      ·
      29 minutes ago

      Doesn’t need any comment:

      int getCount() { return count; }

      Absolutely needs a very extensive comment:

      double getBojangleFlux { return fubar * .42; }