Programmer Humor

19585 readers

485 users here now

Welcome to Programmer Humor!

This is a place where you can post jokes, memes, humor, etc. related to programming!

For sharing awful code theres also Programming Horror.

Rules

Keep content in english
No advertisements
Posts must be related to programming or programmer topics

founded 1 year ago

MODERATORS

[email protected]

1535

How programmers comment their code (lemmy.dbzer0.com)

submitted 4 months ago by [email protected] to c/[email protected]

145 comments fedilink hide all child comments

https://nitter.poast.org/denicmarko/status/1774077890281267451

top 50 comments

sorted by: hot top controversial new old

[–] [email protected] 3 points 4 months ago* (last edited 4 months ago)

Our code base is filled with “//constructor”, “//destructor”, “//assignment”, or the ever enlightening “Foo GetFoo() // GetFoo”.

This is not what they mean by self-documenting code.

[–] [email protected] 3 points 4 months ago

At work we let Typescript and descriptive naming document our code. Only when something is a workaround or otherwise weird will we add comments. So far it has worked great for us.

[–] [email protected] 16 points 4 months ago (1 children)

I got a media failed to load error at first and thought that was the joke

[–] [email protected] 2 points 4 months ago

Both jokes can be true 😅

[+] [email protected] -10 points 4 months ago* (last edited 4 months ago) (1 children)

this is why i very rarely comment with descriptive comments. If you're reading my code and don't understand what it is, even with how shit it is, you have no business reading whatever fucking crackpot shit im writing.

[–] [email protected] 7 points 4 months ago (1 children)

You must be fun to work with.

[–] [email protected] -2 points 4 months ago (1 children)

you say this like im the type of person to write code with other people.

[–] [email protected] 3 points 4 months ago (1 children)

Doesn't matter. Even if it's your code, you might revisit something you made months or a year after doing it and having comments will speed up your work. It's a very basic good practice.

[–] [email protected] 0 points 4 months ago

i do have comments, for some things, but there are a lot of "commenting" standards that are just shit. I find i don't care what the actual piece of code is doing, i care more about it's place in the rest of the code, and i'd much rather have "anti comments" instead.

[–] [email protected] 3 points 4 months ago

Fs.?g??yy V>

load more comments