I was hired to fix, not to read 😤

3 years ago by TheWaterGod to c/techsupportmemes

Madrigal 73 points 3 years ago

Most READMEs are terrible. The biggest issue many of them make is failing to include one or two simple examples.

path: 0 2894702, hotness: undefined, score: 73, children: 2

mestari 15 points 3 years ago

Exactly! It's so frustrating. I mainly deal with Eurocode, not computer code but the issue exists there too. It's so vague that there's whole another industry of people trying to decipher and explain what the code means and how it's applied. The lack of examples have really driven people to insanity lol. In structural engineering there's often no easy ways to test if your results are correct or not if you misunderstood the code...

path: 0 2894702 2896315, hotness: undefined, score: 15, children: 0

cheery_coffee 10 points 3 years ago

path: 0 2894702 2897558, hotness: undefined, score: 10, children: 0

silas 41 points 3 years ago

I’ve always been confused by “README”s. I wish the name was more self-explanatory

path: 0 2891697, hotness: undefined, score: 41, children: 3

stilgar 21 points 3 years ago

IFYOUARECONFUSEDYOUSHOULDREADTHISDOCUMENTTHENYOUWILLBELESSCONFUSED.md

path: 0 2891697 2893904, hotness: undefined, score: 21, children: 1

accidentalloris 3 points 3 years ago

ITSALLINSCREAMINGCASEIMSOCONFUSED.md

path: 0 2891697 2893904 2930112, hotness: undefined, score: 3, children: 0

unsaid0415 8 points 3 years ago

path: 0 2891697 2897537, hotness: undefined, score: 8, children: 0

TemporaryBoyfriend 27 points 3 years ago

As a consultant, my superpower is having read all the READMEs that come out for the software I specialize in, and re-reading them each time a customer calls and complains about a specific bug on an old version of the software.

path: 0 2892638, hotness: undefined, score: 27, children: 0

unsaid0415 20 points 3 years ago

path: 0 2897561, hotness: undefined, score: 20, children: 0

xantoxis 13 points 3 years ago

A few hours of trial and error will teach you a dozen things that aren't IN the readme. Like, I get your point, but that time isn't wasted.

path: 0 2893846, hotness: undefined, score: 13, children: 1

Swedneck 2 points 3 years ago

Exactly, it's basically just the same instinct as dismantling toys, people have an urge to learn

path: 0 2893846 2894585, hotness: undefined, score: 2, children: 0

F4rtEmp3r0r 11 points 3 years ago

Those files are a trap to root out us illiterates!

path: 0 2892653, hotness: undefined, score: 11, children: 1

Coehl 2 points 3 years ago

path: 0 2892653 2899157, hotness: undefined, score: 2, children: 0

thisisawayoflife 10 points 3 years ago

Reminds me of "Weeks of coding can save you from hours of planning."

path: 0 2896730, hotness: undefined, score: 10, children: 0

AllonzeeLV 8 points 3 years ago

Lets be honest, READMEs and other documentation often contain more glaring, misdirecting errors than the software itself. I prefer video demos prior to use if at all available.

path: 0 2893630, hotness: undefined, score: 8, children: 2

Jumper775 10 points 3 years ago

Even those can be hard to follow sometimes, I prefer obscure threads on generic Linux forums from 8 years ago where available.

path: 0 2893630 2894481, hotness: undefined, score: 10, children: 0

lightnsfw 6 points 3 years ago

Dear god no, I can't hit ctrl+f in a video.

path: 0 2893630 2897892, hotness: undefined, score: 6, children: 0

jungekatz 8 points 3 years ago

Me who generally reads readmes , am i doing it wrong 😰

path: 0 2894254, hotness: undefined, score: 8, children: 3

xpinchx 8 points 3 years ago

My favorite is repositories that come with demos - I ain't reading shit I'm just gonna copy a demo that's close enough to what I'm trying to do and change a couple things.

path: 0 2894254 2894405, hotness: undefined, score: 8, children: 2

cheery_coffee 4 points 3 years ago

path: 0 2894254 2894405 2897609, hotness: undefined, score: 4, children: 1

xpinchx 1 point 3 years ago

I see you have higher standards than me :D

Full disclosure I'm not a programmer by trade but occasionally script to automate stuff at work (or for fun)

path: 0 2894254 2894405 2897609 2898075, hotness: undefined, score: 1, children: 0

NathanielThomas 5 points 3 years ago

All these Linux nerds know sudo rm -rf but do they know:

RTFM

path: 0 2894150, hotness: undefined, score: 5, children: 1

cheery_coffee 2 points 3 years ago

path: 0 2894150 2897651, hotness: undefined, score: 2, children: 0

BaronDoggystyleVonWoof 5 points 3 years ago

They are just so boring though.

path: 0 2893179, hotness: undefined, score: 5, children: 2

expatriado 3 points 3 years ago

i only read them if formatted as a chain of memes

path: 0 2893179 2893467, hotness: undefined, score: 3, children: 1

smashboy 2 points 3 years ago

I only read them if they are in the form of vintage, classic memes. “O RLY?” owl or better.

path: 0 2893179 2893467 2894021, hotness: undefined, score: 2, children: 0

Potato_in_my_anus 0 points 3 years ago

Readme's are for amateurs...

path: 0 2893068, hotness: undefined, score: 0, children: 0

techsupportmemes

techsupportmemes

@lemmy.ca

login for more options

Memes about IT and computer related things, funny screenshots, or things you see out in the wild.

go to feed...

techsupportmemes

techsupportmemes

@lemmy.ca

login for more options

Memes about IT and computer related things, funny screenshots, or things you see out in the wild.

go to feed...