• coloredgrayscale@programming.dev
    link
    fedilink
    arrow-up
    6
    arrow-down
    1
    ·
    1 year ago

    If someone changes the code and forgets to modify the comment, the reader might favor one or another at random.

    Hence why you should comment why, not how/what.

    // slow down traffic before crossing busy main road

    Now you can change the stop sign to a yield without touching the comment. Or judge that the comment can be removed if it’s clear the main road does no longer exist.