• DampCanary@lemmy.world
    link
    fedilink
    arrow-up
    1
    ·
    1 day ago

    After few years in programming I can attest that “Write Self-Documenting Code” doesn’t hold. No matter how much coder thinks their code is self explanatory.
    An addition of nice, concise, and blunt comment on critical points in function saves heads (and brains) of whoever comes next.
    Writing comments is cheaper in long run, than any clever variable/function naming. (note: I’m not saying that names should be abstract, but by them self are not enough to make code user frendly).