It’s in my head it must be in yours. Why all documentation sucks ass!!!

Most documentation sucks. It seems most authors have this idiotic idea that whatever is in their head, all their knowledge etc. magically transfers to the user as they read it. These are the same kind of idiots you meet in society that drone on about shit they understand to the totally uninitiated like they are talking to a pro. These are the kind of idiots that while talking don’t even have the ability to notice their true live audiences eyes glazing over and heads shaking in confusion. Nope these idiots are comfortable being idiots and we have to suffer. I don’t get it.

Makes sense right?

Ever been reading along documentation and the author just keeps throwing out concepts/terms left and right without even giving a link, leaving you in the dark like WTF? Causing you to have to dig and google and dig. Isn’t it fun?

The docs suck ass these days so bad

Here is a tip to anyone who writes documentation. No matter how stupid simple a concept seems to you, there will be people, many people who have never come across the concept or who briefly encountered it, didn’t use it in depth and forgot it.

Learn Humility

You are not the worlds brightest genius because you wrote some code or understand some silly ass concept.  The tech industry tends to attract idiots who impress themselves by doing shit with code. This makes them feel superior, they have knowledge others don’t.

When the programmer of the code writes the docs…

Instead of being a snobby dickhead with an attitude like “Well you have to have a minimum idea of how blah blah blah works because I do”. You should provide information, links etc. to any concept that anyone may not have encountered.  It is not that damn hard and doesn’t take much time and it makes you look much smarter and much less conceited and narcissistic.

This is the exact reason I started this website. So much of the documentation for everything sucks ass. Most documentation I come across these days leaves me saying WTF. Look at openssl or openssh or example so many WTF’s in those docs.

And what is worse is the assholes who write blogs who just copy other blog posts. So you get entire search pages full of shit articles all repeating the same wrong shit that doesn’t work. PYTHON!!! Then that shit information ends up on stackxxxx.com sites from idiot kids who copy and paste shit for points and don’t care if the answer is right, they just want popular points. I often just avoid stack sites these days. Those sites are only handy if you are doing the most basic simple shit. Once you go into complex issues those sites are wrong answer land 100% of the time. They are actually more useful for finding bugs and how to temporarily solve them.

Garbage Docs Awards

I am so tired of shitty docs I am starting an award list here. This list will contain docs that DON’T WORK OR ARE MISSING NEEDED INFO.

# Github lfs

What a pile of Barf these docs are. For one they are totally wrong. It says RIGHT IN FUCKING DOCS.

Download and install the Git command line extension. Once downloaded and installed, set up Git LFS for your user account by running:

git lfs install

So you download it, unpack it, navigate to where you unpacked it and try the command.  WHAT DO YOU GET?  Just guess what you get?

git: ‘lfs’ is not a git command. See ‘git –help’.
The most similar command is
log

OK WTF does this BS mean? What did I miss? MORE LIKE WHAT DID YOU MISS IN THE DOCS? Did you assume I am using your favorite Linux OS? Did you assume I know something that is in your fucking head? Did you assume I had some sort of configuration you didn’t tell me I needed? W…T…F???

Seriously?

This is how I spend all my fucking free time. Trying to figure out how each and every fucking part of every fucking piss poorly documented tool I use works. THIS SHIT HAS TO STOP!!! That is what this list of SHAME is all about.

This is a really old ass issue too.

This issue is at least 4 years old and you clowns can’t update the docs? What you get off on wasting peoples time? GOOD GET OFF ON LIVING ON MY LIST OF SHAME.

Why does this even exist? Because github is too cheap to add the software and have it run on their side so they much rather waste the developers time until they decide FUCK GITHUB and look for something new. Gitlab, bitbucket and others don’t have this hassle.

If there is something the user is supposed to do before running the command TELL THEM!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! WHAT FUCK IS HARD ABOUT THAT SHIT? WHAT THE FUCK IS SO FUCKING HARD ABOUT THAT SHIT YOU SLOW MOTHER FUCKERS!!!!!!

At this point I hate the industry with a passion. It is like constantly dealing with RETARDS. Full on RETARDS. The whole tech industry is full of fucking RETARDS. I STRESS THAT FUCKING WORD… RETARDS. It is not worth the constant frustration anymore. I am not retarded  I don’t want to deal with the retarded.

 


Posted

in

by

Tags:

Comments

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: