• pfm
    link
    fedilink
    arrow-up
    8
    ·
    1 month ago

    You’re definitely not the only one.

    In my opinion the important information we should record in comments is WHY, because the code can only explain HOW, maybe WHEN, but never WHY. If we don’t know WHY, any refactoring done in the future could break the logic by ignoring assumptions made by the authors.