(Alt: The Drake meme. Upper panel shows him hiding his face from “Securing Customer Data”. Lower panel shows him smirking at “Securing Public API Documentation”)

65 points
*

Any company that hides their documentation has an awful product that they are actually embarrassed about, from a tech perspective. They are hiding it because they are afraid to show it.

I’ve seen this so many times, and it’s a big red flag.

These companies work on the basis of selling their product the old-fashioned way, directly to management with sales-people and business presentations and firm handshakes, and then once you’re sold then developers (which management doesn’t care about by the way) have to do the odious task of getting everything working against their terrible and illogical API. And when you need help implementing, then your single point of contact is one grumpy-ass old dev working in a basement somewhere (because they don’t care about their own devs either) and he’s terribly overstretched due to the number of other customers he’s also trying to help, because their implementation is so shitty.

Conversely, public documentation is a great sign that companies took a developer-led approach to designing their solution, that it will be easy to implement, that they respect the devs within their own company, and they will also respect yours.

When I am asked to evaluate potential solutions for a problem, Public docs is like the number one thing I care about! It’s just that significant.

Side story - I once worked with one of these shitty vendors, and learned from a tech guy I’d made friends with that the whole company was basically out of office on a company-paid beach holiday - EXCEPT for the dev team. Management, sales, marketing, finance, they all got a company trip, but the tech peeps had to stay at home. Tells you everything you need to know about their management attitude towards tech.

permalink
report
reply
15 points

Haha sounds so familiar.

The duality of “we’re a tech company! :D” on the outside and “IT is a good for nothing cost centre >:(“ on the inside

permalink
report
parent
reply
12 points

Been there many times. Had one case where support had to through the reseller who sold licenses in our country. Actual people who knew what they were talking about was tier 3.

We had a bug and were trying to report it and get a fix or workaround. Just told no, we’re doing it wrong. After a lot of back and forth we had to pay for an “expert” to fly over and show us what we were doing wrong. Turns out he wasn’t an expert, he was a salesmen. Made a demo for us on the flight and the first time he ran it was in our meeting room on projector.

Failed in exactly the way we had been saying. It was very satisfying.

Finally he phoned the dev team who confirmed the docs were wrong and we couldn’t do what we were trying.

permalink
report
parent
reply
6 points
*

Haha yep. Not the support process you want. Glad you managed to let them eat some humble pie at least.

The support process you want is this: “We’ll make you a channel on our Slack, if you’ve got any issues you can talk with our devs direct!” - yes please!

permalink
report
parent
reply
4 points

Definitely. What I didn’t mention is all that took over a month!

permalink
report
parent
reply
11 points

Fun story! At a conference, I asked this vendor (the company collapsed now) if I can see their documentation. The obvious sales person made a big stink how it’s only for paid customers and I can see it when I paid.

I told him how stupid it was since his competitors have their docs open.

During a conference’s event where they parade their sponsors, the vendor got on stage and called me out with “And paid customers will have a wealth of support, like developer documentation… Especially for you [name]”.

In my nerd rage, I shouted from the audience “What kind of shit software is afraid to share their developer docs publicly?” I was escorted out by security.

And during the night event when everyone mingles (including sponsors), the guy didn’t show up. And apparently, news got around where by the last day of the event, the entire booth was taken down.

I dunno if it was me shouting and everyone agreeing with me, or the conference realizing that attacking a paid member of the audience wasn’t a good idea and told him to leave.

Either way… Tell it to their faces when their product isn’t dev friendly. These charlatans seem to get bolder and bolder with their garbage.

permalink
report
parent
reply
6 points

That’s gotta be satisfying that your vengeful anger took down their whole booth.

permalink
report
parent
reply
31 points

No Drake pls

permalink
report
reply
58 points

Wie schon letztens geklaut:

permalink
report
parent
reply
8 points

What has happened with drake? I’ve seen this message pop up in some memes, but don’t understand why.

permalink
report
parent
reply
20 points

Well apart from how tired the “this thing is bad, this thing is good” meme format is, I think there are credible allegations of grooming?

permalink
report
parent
reply
7 points

Plus all the political stuff. The man is patantly off his rocker.

permalink
report
parent
reply
13 points

He’s a certified pedophile (wop wop wop wop wop)

permalink
report
parent
reply
6 points

That really struck a chord. It was probably A Minor

permalink
report
parent
reply
12 points

Actress Millie Bobby Brown, aka Eleven from Stranger Things, revealed when she was still a minor that Drake and her used to text each other. Particularly concerning advice about Drake’s similar experience being a child actor.

In 2018, Drake reportedly dated, then 18 year old model, Bella Harris. However there are posts of them in intimate positions as old as 2016, where she would’ve been 16 years old.

https://www.reddit.com/r/OutOfTheLoop/comments/1c91nnr/comment/l0ikqdf/

permalink
report
parent
reply
8 points

Holy shit. Thanks for sharing that information, I’ve been trying to stay away from social media, and I’ve been very much OOTL.

permalink
report
parent
reply
8 points

I’m in a position to call him a groomer. I feel comfortable saying straight up he’s a sex pest. There’s credible allegations all over the place. What I can’t speak to, and I have to implore you to look into, is that many black people in America consider him a cultural appropriator based on his adoption of vernacular and accent that aren’t his own.

permalink
report
parent
reply
4 points

I’ve been trying to stay away from social media, and I’ve been very much OOTL. But I’ve researched about this meanwhile, and holy shit, this was not in my bingo card.

permalink
report
parent
reply
23 points

Pdf documentation? Ewww…

permalink
report
reply
5 points

It’s a PDF in slideshow format after you give them your email.

permalink
report
parent
reply
8 points

Did I miss some follow up news on microsoft blaming EU? Or is it just a meme (so far)?

permalink
report
reply
37 points

No, this is a general practice-- I see it a lot with third-party vendors who want you to integrate with their services. They’ll expire the documentation portal password after 90 days, but the actual user facing service still accepts the same “password123” that’s been set since 2004.

I suspect the pattern is to protect the vendors from developer scrutiny: by the time you’ve jumped through enough hoops to read the docs and realize it’s trash, the execs have signed the contracts and the sunk costs are too high to bail out.

Also add another 6 months to actually get the credentials for the test environment.

permalink
report
parent
reply

the test environment

The test environment? I don’t miss the web dev world. It’s so nice to be able to run end-to-end tests entirely locally.

permalink
report
parent
reply
8 points

Microsoft did what? oO

permalink
report
parent
reply
15 points
14 points

Of course Microsoft has to come out with this THE ONE TIME they’re not to blame for broken software…

permalink
report
parent
reply
2 points

datev?

permalink
report
reply

Programmer Humor

!programmer_humor@programming.dev

Create post

Welcome to Programmer Humor!

This is a place where you can post jokes, memes, humor, etc. related to programming!

For sharing awful code theres also Programming Horror.

Rules

  • Keep content in english
  • No advertisements
  • Posts must be related to programming or programmer topics

Community stats

  • 3.4K

    Monthly active users

  • 1K

    Posts

  • 37K

    Comments