• xmunk
    link
    fedilink
    arrow-up
    4
    ·
    6 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
      ·
      2 hours ago

      Doesn’t need any comment:

      int getCount() { return count; }

      Absolutely needs a very extensive comment:

      double getBojangleFlux { return fubar * .42; }