707

Bill is a pro grammer (sh.itjust.works)

submitted 1 year ago by CowsLookLikeMaps@sh.itjust.works to c/programmer_humor@programming.dev

97 comments fedilink hide all child comments

you are viewing a single comment's thread
view the rest of the comments

[-] wit@lemmy.world 10 points 1 year ago

Code should be self documenting.

[-] JohnDClay@sh.itjust.works 20 points 1 year ago

But you should also comment it, things obvious to you aren't obvious to even future you.

[-] gornius@lemmy.world 6 points 1 year ago

General rule of thumb: Comments say why is it here, not what it does. Code itself should describe what it does.

[-] Sylvartas@lemmy.world 10 points 1 year ago

But then you write code in the real world and find out that you have to write some ass backwards code every other day because of deadlines, backwards compatibility or whatever, and suddenly you realize that despite your best efforts, code cannot always be self documenting.

Source: me.