• nothacking@discuss.tchncs.de
    link
    fedilink
    arrow-up
    1
    ·
    edit-2
    11 months ago

    I reserve comments for explaining why a section of code is needed or explaining how a complex algorithm works.

    i = 0; // Set i to 0 is pointless.

    if (last_output_vertex[i] == bounds[i]->length - 1) contibuting_bounds[i] = NULL; // stop outputting a bound if the entire bound has been output is helpful.

    • JonEFive@midwest.social
      link
      fedilink
      arrow-up
      1
      ·
      11 months ago

      Comments can also be useful for explaining what the code is intended to do when debugging.

      “Hey this function says it should return the number of apples, but looks like someone, not saying who, but someone had a brain fart and typed oranges in one variable. Who wrote this code anyway?”

      -Last edited by JonEFive in 2021-

      Past me sucks.