Using "self documenting" as a blanket excuse to not document things that need it is inexcusable, yes, but I'd rather work on code written by somebody who seriously thinks about how to make it clean and self documenting, and then documents whatever still needs it as well, than on code written by somebody who doesn't make that effort, but documents heavily. And as for people who claim they're documenting everything, when the documentation is function fooTheBar() // foos the bar, they can eat a bag of docs.
23 Comments
SpaceNoodle@lemmy.world · 52 pts · 2y
"This would be better if it were covered in rust"
bob_wiley@lemmy.world · 24 pts · 2y
TheYear2525@lemmy.world · 13 pts · 2y
Gee whiz, that pun was basic!
entropicdrift@lemmy.sdf.org · 5 pts · 2y
They can't all be perls before swine
nogrub@lemmy.world · 2 pts · 2y
i C what you did there
yum13241@lemm.ee · -4 pts · 2y
Maybe too BASIC.
nieceandtows@programming.dev · 8 pts · 2y
They’ve played us for absolute fools!
QuazarOmega@lemy.lol · 43 pts · 2y
This engine is not the best practice
andrew@lemmy.stuart.fun · 40 pts · 2y
This engine is an antipattern.
QuazarOmega@lemy.lol · 11 pts · 2y
We're dissing Unity here right?
andrew@lemmy.stuart.fun · 6 pts · 2y
Could also be your least favorite container engine. Or rules engine. Man, we really like to call things engines don't we?
Knusper@feddit.de · 4 pts · 2y
This engine is not idiomatic.
TootSweet@lemmy.world · 32 pts · 2y
"Documentation considered harmful" - my coworkers probably.
railsdev@programming.dev · 22 pts · 2y
redcalcium@lemmy.institute · 11 pts · 2y
It perfectly makes sense if you think like me.
-- a deranged programmer
QuazarOmega@lemy.lol · 9 pts · 2y
Aren't we all?
docAvid@midwest.social · 6 pts · 2y
Using "self documenting" as a blanket excuse to not document things that need it is inexcusable, yes, but I'd rather work on code written by somebody who seriously thinks about how to make it clean and self documenting, and then documents whatever still needs it as well, than on code written by somebody who doesn't make that effort, but documents heavily. And as for people who claim they're documenting everything, when the documentation is
function fooTheBar() // foos the bar, they can eat a bag of docs.railsdev@programming.dev · 1 pts · 2y
TheYear2525@lemmy.world · 5 pts · 2y
funkless_eck@sh.itjust.works · 5 pts · 2y
ticket is too exposed, what if they reverse engineer the name? just use t2387ac3 instead it saves time
hairyballs@programming.dev · 2 pts · 2y
My coworkers do document the code:
UnRelatedBurner@sh.itjust.works · 2 pts · 2y
facts
princess@lemmy.blahaj.zone · 18 pts · 2y
“Considered Harmful” Considered Harmful, 2002
profoundlynerdy@programming.dev · 4 pts · 2y
Perl has entered the chat.
WhiskyTangoFoxtrot@lemmy.world · 3 pts · 2y
No, that's just some random line noise.
gregorum@lemm.ee · 7 pts · 2y