Maintaining software built by interns who have all quit by now and made zero documentation

The react documentation can be taken wildly out of context!

And the award for the best API documentation goes to...

Microsoft!

Documentation 🤷‍♂️

So this is going to be one hell of a FUCKING rant.
Just heard from a friend (doing the same exams I passed, it was going to happen in two groups and he was in the second) that he failed the first out of three phases. And why?
I NEARLY FUCKING FAILED THE FIRST FUCKING PHASE. I GOT A FAIR CHANCE TO MAKE IT RIGHT AND I TOOK THAT CHANCE.
BUT.
MY FRIEND MADE THE SAME MISTAKE. HE MISSED A FUCKING DOCUMENT AND ASKED FOR OVERTIME, WHICH HE GOT AND THEN HE ASKED THE EXAMINOR VERY NICELY IF HE COULD TELL HIM WHAT DOCUMENT HE MISSED (for the record, it was bad documentation and it was not clear that it had to be a seperate document) AND WHAT DID THAT FATHERFUCKING COCKSUCKER SAY?
Hmm hmm hmmm.... nope, that's your responsibillity

ARE YOU FUCKING KIDDING ME? HE HELPED ME BUT NOT HIM? I KNOW YOU LIKE ME MORE THAN HIM BUT IS THAT A MOTHERFUCKING REASON TO LET HIM FUCKING FAIL?!?!?!?

I AM MOTHERFUCKING FUCKITY FUCKING FURIOUS.

Jesus Christ. Dagger2's documentation has got to be the most convoluted shit I have ever laid my eyes on.

The sheer mental gymnastics I had to do to get through this one line at 2:30 am...

!rant

Today I bring happy news. First company I interviewed at clicked so well, both personally and technically, and they expressed an eagerness to hire me on the spot. I figured we might as well talk salary to compare them against other interviews. The offer they made me was so good I decided to sign there and then. They said they participate in a fair wage program but for me this is absolutely the dream. I get lots of nice perks to boot. And they've already mailed me some tech documentation to go over so I can prepare, as I'll be working with the latest front end stuff and of course my trusty .NET (and yes I asked it'll be C#, haha).

I can't even begin to express how great this is. The last decade I've been unemployed for several years in total, and vastly underpayed when I was employed. I've worked in some toxic environments, been falling behind on tech and wrote a lot of rubbish code as a result of that. But it seems that somehow all the hard work I did put in paid off by taking a chance when it presented itself and go in accepting I might fail horribly. And I did bomb the tech questions actually. But they let me explain myself and come to answers together and saw beyond the black and white.

In short I feel like I've won the work lottery and will start 2018 in style. Part of me is still scared though, that there will be a mistake or a catch or even somehow I'll ruin everything. But that is the risk in life and I'm just going to have to deal. What I can control and will do is my very best, because I want to keep succeeding and have a great future career. And I hope I can inspire others in the same boat with my actions too.

Happens all too often

I tried to contact a big German company about an API endpoint we might want to build a connection to. The docs are behind a login. I request login info through a form and get a mail that my request will be checked and I'll hear from them in 2-3 days. Because my boss wants this info until Friday, I try to call them.
First try: "we currently have a disruption in our phone central, please try again later"
2nd try: "sure, I'll put you through! *beep beep* - connection broke off
3rd try: "this number is not in use" (I used redial, didn't make a typo)
4th try: same as the 2nd try, again.
German red tape and technology at its finest. Fml.

Found in JavaFX documentation.
Biggest range I've ever seen...

Android really gets on my goat. They are moving things so far that they are actually doing more damage than good.

Upgrade my build tools to v25? sure! Now all my BLE code is borked, thanks for nothing.

Go to the documentation? Lol, that's deprecated fool!

At least now it can all fail to function in Kotlin, a wrapper for Java 6. Instead of keeping your tools up to date you just create another layer of obfuscation. Well done, so proud.

Fukken School project

I spent days writing good documentation with step-by-step tutorials. I broke the project down into small, simple tasks.
Trying so hard to make everyone’s job easy.

And they still fail.

Give me a cookie

Team lead wants me to document a 7000 line code in 2 days. Tell me about it

When I was at university in my last semester of my bachelor's, I was doing a game programming paper and our last assignment was to group up and make a game. So I go with one of the guys I know and this other dude since his previous game was really neat. Then two randoms joined that from my first impressions of their games wasn't much at all (one guy made four buttons click and called it a game in Java when we had to make games in c++ and the other guy used an example game and semi modded it.

Anyways we get to brain storming, totally waste too much time getting organised because the guy that volunteered (4 buttons guy) was slow to getting things sorted. Eventually we get to making the game and 4 buttons guy hasn't learnt how to use git, I then end up spending 3 hours over Skype explaining to him how to do this. He eventually learns how to do things and then volunteers to do the AI for the game, after about a week (this assignment is only 5 weeks long) he hasn't shown any progress, we eventually get to our 3rd week milestone no progress from him and the modder, with only three classes left we ask them both to get stuff done before a set deadline (modder wanted to do monsters and help 4 buttons with AI) both agreed and deadline rolls up and no work is shown at all, modest shows up extremely late and shows little work.

4 buttons guy leaves us a Skype message the day of our 2nd to last class,, saying he dropped the paper...

Modder did do some work but he failed to read all the documentation I left him (the game was a 2d multiplayer crafting game, I worked so hard to make a 2d map system with a world camera) he failed to read everything and his monsters used local coordinates and were stuck on screen!

With about a week left and not too many group meetings left we meet up to try and get stuff done, modder does nothing to help, the multiplayer is working my friend has done the crafting and weapon system and the map stuff is working out well. We're missing AI and combat, with our last few hours left we push to get as much stuff done, I somehow get stuck doing monster art, AI is done by the other two and I try to getting some of the combat and building done.

In the end we completely commented all of modders work because well it made us look bad lol. He later went to complain to my free claiming I did it and was a douchebag for doing so. We had to submit our developer logs and the three of us wrote about how shitty it was to deal with these two.

We tried out best not to isolate ourselves from them and definitely tried to help but we were swamped with our other assignments and what we had to work on.

In the end leaving and not helping right when the deadline is close was what I call the most shittiest thing team mates can do, I think sticking together even if we were to fail was at least a lot better.

You know what is disappointing?
When you struggle with something and then you discover that the solution was clearly stated in the documentation.
In short, I'm an idiot. But I still got one upvote on my question on stackoverflow so apparently I'm not the only idiot out there. Arigato, idiot-tachi, we need to stand together so we can fail together.

Email chains, screenshots shared in google docs, two comments per 1k lines of code, and sticky notes are sufficient documentation, right? RIGHT?

My boss asked me two days ago to fix some errors in an application. From the errors I saw it would be a 5 minute fix. I fixed the problems just now because there was no documentation on how to set it up.
After setting it up it was just changing a value from true to false...

I ruined two days just because there was no documentation. Please everyone, I know writing documentation is boring but at least write some documentation on how to setup a project.

Companies that create APIs and then update them but fail to update the documentation, to a point where the syntax doesn't even remotely resemble how it originally was, or even give the location of where the new endpoint is.
WHY MUST YOU MAKE MY LIFE HELL

TeamViewer documentation
wanted to find out some command line args and they show me this..

Me: "Need help with build config problems, please help almighty documentation page!"

Docs Page: "Nah fam, I got 4 headers about problems with no text, a blank code example, and 2 error 404 pages."

And that's why I don't like build pipelines.

PM: "Can you take a look at this app and see if you can find why it's producing errors and fix it"
Me: "Yea sure, can I see the documentation so I might be able to understand the system and why it's doing that?"
PM: "There's no documentation" ... "Also it was cowboy coded by an intern"

Apparently my learning style is more rote memorization than learn-by-doing and I've been trying to learn by doing for years as a hobbyist.

It took a fucking *national quarantine* to get me to try something different and I'm blown away.

What would have taken me many months to learn I've all but grasped in detail in a matter of 20 hours of study over the course of a week.

Fuck you javascript. I WIN THIS ROUND. No more looking at the documentation for stupid shit like how to write a regex, or why everything is wrapped in fucking parenthesis (IIFE), or why
I keep getting a uncaught reference exception.

The important thing to realize about learning is NEVER be obstinate about it. Try many things, and don't get stuck in one way of learning unless you know thats what works for you.

This is why having study partners and mentors are important.

I think experience/practice and rote learning work in tandem. Rote learning lets you skip the much longer step of grasping the fundamentals, bootstrapping the process of learning the abstractions that are composed of those fundamentals.

I'm still adding cards to my anki flash card deck, but if anyone wants it I'm willing to share. It's mostly just 1. practice questions, 2. detail questions (what are the types? What does this regex do?, etc), 3. implication questions (heres this bit of code. It's XYZ, why did it fail? Correct it.), combining core details to memorize, and the application of the facts learned.

It helped me to learn and I'm apparently retarded, so if you're new to programming and want to learn JS, it can probably help you too. Unless you're more of a tard than me lol.

Got into the job a week ago, was asked to do a documentation of a project. It started 4 years ago.

SO MAD. Hands are shaking after dealing with this awful API for too long. I just sent this to a contact at JP Morgan Chase.

-------------------
Hello [X],
1. I'm having absolutely no luck logging in to this account to check the Order Abstraction service settings. I was able to log in once earlier this morning, but ever since I've received this frustratingly vague "We are currently unable to complete your request" error message (attached). I even switched IP's via a VPN, and was able to get as far as entering the below Identification Code until I got the same message. Has this account been blocked? Password incorrect? What's the issue?

2. I've been researching the Order Abstraction API for hours as well, attempting to defuddle this gem of an API call response:

error=1&message=Authentication+failure....processing+stopped

NOWHERE in the documentation (last updated 14 months ago) is there any reference to this^^ error or any sort of standardized error-handling description whatsoever - unless you count the detailed error codes outlined for the Hosted Payment responses, which this Order Abstraction service completely ignores. Finally, the HTTP response status code from the Abstraction API is "200 OK", signaling that everything is fine and dandy, which is incorrect. The error message indicates there should be a 400-level status code response, such as 401 Unauthorized, 403 Forbidden or at least 400 Bad Request.

Frankly, I am extremely frustrated and tired of working with poorly documented, poorly designed and poorly maintained developer services which fail to follow basic methodology standardized decades ago. Error messages should be clear and descriptive, including HTTP status codes and a parseable response - preferably JSON or XML.
-----

This whole piece of garbage is junk. If you're big enough to own a bank, you're big enough to provide useful error messages to the developers kind enough to attempt to work with you.

Are you asking me?

That feeling when you open link that's supposed to lead to the index of documentation and you find this...

The rest was.. unfinished..

#fml

Googling for Angular (>=2) documentation and finding AngularJS instead feels like cancer.

If Google was going to "update" to what is functionally a new framework, they should've named it differently instead of trying to piggyback on the popularity of AngularJS. Sure, there's similarities, but let's be realistic here.

When some gotchas aren’t documented so you need to trial and error the api

Started a new contract:
Dev: "here, take this draft document containing a rough explanation of the requirements and write this service that exchange messages with these two subsystems"
Me 😐"ok"

-- couple weeks later --

Dev: "oh btw, you should go through ALL the fields in those messages described in the 'documentation' and double check them because we use millimeters and they use meters, we measure milliseconds and they use seconds. You should handle conversions when you deal with those messages"

Me (in my mind): "fucking son of a bitch! Why didn't you tell me this little piece of information at the beginning so I could have accounted for that instead of bloating the code now with your spaghetti style, full of horrible hacks, ifs and workarounds?
Me 😐: "sure, I will"

(don't worry, in the end I managed to find a clean solution for that 😉)

Client: I'm not able to see the mount storage
Me: share your configuration
Client: 📃

Me: (frustrated but still kind and polite) I see the ports are swapped between hosts which is the culprit behind the issue.
Me: can I ask the reason behind doing this?

Client: I thought red color goes left and aqua goes right.
Me: 🦍 🤐🤐

Very useful!
It's not just about code but the whole package.
Watching great programmers fail miserably at project management, research, documentation, team leading and acting professional is just embarrassing, especially when they slate those who went out to educate themselves.

🎙️ Mic drop, I'm out!

Need to use new module or pattern:

1. Read the online documentation
2. Have no fu*kin clue what I just read
3. Try for 2 hours and fail.
4. Go home and sleep
5. Wake up at 3am from a fever dream with the solution to the problem
6. Go to work and implement it in 10 min

I guess I learn when I sleep

FUCK you "WP iThemes Security Pro".

First of all, your FUCKing services isn't really secure, more like security by obscurity.
Don't get me started on how you probably don't have a dedicated team of security experts.
But oh well, the customer insisted I must install you, despite my advise.

Second of all, Don't FUCKing send me emails regarding "Scheduled malware scan failed" without it containing the FUCKing error message, not some generic "http_request_failed" error, why did it FUCKing fail?

Last but not least: Don't FUCKing clutter is with with your giant ass logo that takes up half my screen or FUCKing spam such as your upcoming events, newly published books/articles, incorrect "documentation"

Hey vendor! Screenshots of code !== code examples/documentation. Let's work together. Please.

Losing faith in Netflix and their awesome open source projects.

Had a hard time trying to install Security Monkey : poor quality quickstart Ubuntu-only, almost no documentation, same instructions for latest (aka dev) and stable (aka prod) version, no depencies list ... oh and the UI display well only on Chrome ..

Then you surrender and just want to check the dockerized version they provide : it doesn't work neither (build fail or back end process just shut down) !!

I'm done ...

About 3 years ago, we had 4 different WordPress sites for various clients.

My colleagues thought it'd be a genius idea to keep them all in one repo. Even more genius, for local development, a single installation which implements a switcher for the wp-config.php files so we can switch between sites. Not bad in theory.

Fast-forward to present day. 1 client left; another site got converted to using Laravel because they always asked us to update their content so no point using a CMS; whereas the remaining 2 sites use differing versions of WordPress on their live sites, no less than 18 months out of date, have no dev sites, different collection of plugins and themes and both modified to the deepest darkest depths of fucking hell that's barely recognisable as WordPress anymore and next to no documentation or comments around the changes.

The functions.php file of one of these themes is over 4000 lines long!!!

We're keen to upgrade our servers to use Ubuntu 16.04 which defaults to PHP7, so all the already deprecated WordPress functions will then fail to work completely as will have been removed.

Both of these clients have agreed that they wish to convert Laravel as well so there's not really much point in going through the clean up process of their WordPress sites. Just copy the database nuke it all and start a fresh with Laravel FFS!

They also wish to completely redesign and discuss what features to keep/add/remove. With no date for these redesign meetings in sight, we won't be converting to Laravel any time soon, nor upgrading our servers in the foreseeable future either!

This is all because of one dev in the office and his history of failing to keep on top of breaking changes!

Fuck you! Seriously, fuck you!!!

If I was your superior, then you'd have been fired long ago!

How the fuck does a community write an open source library/package that works wonders, but fail to write a proper documentation.

So many times I have to look into the core of frameworks, libraries and packages so form my own documentation in my head.

I guess I should be contributing too.

We are all to blame.

1) Browse high level documentation on the matter.
2) Find a semi-guided source of in-depth material (usually a book).
3) Start working with the technology.
4) Supplement with YouTube tutorials if necessary.
5) Fail initially.
6) Eventually succeed after much persistence.

nothing new, just another rant about php...
php, PHP, Php, whatever is written, wherever is piled, I hate this thing, in every stack.

stuff that works only according how php itself is compiled, globals superglobals and turbo-globals everywhere, == is not transitive, comparisons are non-deterministic, ?: is freaking left associative, utility functions that returns sometimes -1, sometimes null, sometimes are void, each with different style of usage and naming, lowercase/under_score/camelCase/PascalCase, numbers are 32bit on 32bit cpus and 64bit on 64bit cpus, a ton of silent failing stuff that doesn't warn you, references are actually aliases, nothing has a determined type except references, abuse of mega-global static vars and funcs, you can cast to int in a language where int doesn't even exists, 25236 ways to import/require/include for every different subcase, @ operator, :: parsed to T_PAAMAYIM_NEKUDOTAYIM for no reason in stack traces, you don't know who can throw stuff, fatal errors are sometimes catchable according to nobody knows, closed-over vars are passed as functions unless you use &, functions calls that don't match args signature don't fail, classes are not object and you can refer them only by string name, builtin underlying types cannot be wrapped, subclasses can't override parents' private methods, no overload for equality or ordering, -1 is a valid index for array and doesn't fail, funcs are not data nor objects when clojures instead are objects, there's no way to distinguish between a random string and a function 'reference', php.ini, documentation with comments and flame wars on the side, becomes case sensitive/insensitive according to the filesystem when line break instead is determined according to php.ini, it's freaking sloooooow...

enough. i'm tired of this crap.
it's almost weekend! 🍻

When the documentation suggests you use composer to install swiftmailer so I can use sendgrid.

Even though I can install composer as an extension and sendgrid is integrated within the portal it's down to me to work out the azure cli or is it a powershell cli or is it bash?

Echo gives kudu error, oh well if there's kudu why am I using composer?

Grrr azure you don't make it easy.

Learning a piece of software from an external supplier. The manual is thick like the bible. The examples fail without explanation. Trying to contact support just leads you down an endless trail of support articles. Damn right I get frustrated and bored. Can you blaim me for rather hanging around on devRant than desperately trying to work around problems in someone else's system/documentation? Yeah, I have to pull my shit together, but they have to pull theirs first.

Very reassuring when your payment gateways XML examples have invalid markup.
I asked for XSD's and even they are invalid (containing missing type references)

Yo what the actual hell is up with the lack of Azure AD B2C documentation, the error codes are pretty ass too! Had a similar problem many users faced & on stackoverflow everyone had different solutions. My solution wasn't the accepted one and it has 2 upvotes ....2 UPVOTES!!