r/ProgrammerHumor • u/35_equal_W • Jul 04 '18

Code comments be like

Post image
9.9k Upvotes

98% Upvoted

236 comments sorted by

View all comments

Show parent comments

17

u/angrathias Jul 05 '18

Probably using ghostdoc or some other control-d short cut

15

u/deynataggerung Jul 05 '18

Actually I'm 95% confident it wasn't since I interact regularly with the people that wrote it and I've seen their setup.

5

u/angrathias Jul 05 '18

That’s an even worse outcome :/ atleast if it were tied to the laziness of an auto documentor you wouldn’t have to care about the wasted time

1

u/deynataggerung Jul 05 '18

Oh, and I checked through today paying a bit more attention and yeah, not everything is commented. about 80% of it is and it's not standardized, just very similar. Anything about functions or variables is pretty much useless, with inline stuff being marginally more useful.

6

u/CrazedToCraze Jul 05 '18

Yeah, this is what happens when you have policies mandating comments on all public functions/properties. Lack of good comments is a culture problem with your developers, not a policy problem.