this post was submitted on 07 Jul 2023
790 points (99.3% liked)

Programmer Humor

32558 readers
712 users here now

Post funny things about programming here! (Or just rant about your favourite programming language.)

Rules:

founded 5 years ago
MODERATORS
 
  • This is Microsoft.
  • He returns Webhook success with a code 200 and plaintext 1.
  • He returns Webhook failure with a code 200 and a string tells its endpoint returned error 400.
  • the string didn't tell what exactly the error.
  • Don’t be like Microsoft.

EDIT: Got a few details wrong since this happens a few months ago and this meme used to be on r/ProgrammerHumor. Also the proof:

you are viewing a single comment's thread
view the rest of the comments
[–] callmepk@lemmy.world 48 points 1 year ago (1 children)

Now here is the fun part: they do not have a API documentation; they only have a very generic guide on how to setup webhook API

[–] candyman337@lemmy.world 35 points 1 year ago (3 children)

Microsoft code docs are the literal worst

[–] masterspace@lemmy.ca 32 points 1 year ago (2 children)

Lmao, Microsoft code docs are absolutely amazing compared to the undocumented bullshit I have to deal with at most companies that have rolled their own services.

[–] LetsGOikz@lemmy.ml 13 points 1 year ago* (last edited 1 year ago)

Shit, Microsoft docs are better than most other large companies with broadly used software even, not just random undocumented BS from smaller companies and products. In my experience, Microsoft's Xamarin docs are somehow often a better guide for Android development than Google's docs (good god are the official Android docs some of the hottest garbage that a company of Google's size and talent could put out), and I've yet to find a better general reference for any language or library than Microsoft's .NET documentation. I've seen a lot of people dunk on it for it's verbosity and/or "example bloat" but I love the length of their docs for breaking down different use-cases and giving examples of each, along with potential misuses and recommended alternatives.

That said, they do still have some garbage docs (like what OP is pointing out), but my general experience with their docs, especially for their larger/more mainstream products, has been surprisingly positive.

[–] candyman337@lemmy.world 7 points 1 year ago (1 children)

Right but Microsoft isn't most companies, it's a SOFTWARE company. A multibillion dollar one at that. Compared to other even multimillion dollar companies, their docs are fucking atrocious

[–] masterspace@lemmy.ca 6 points 1 year ago (2 children)

Not my experience at all. What specific docs are you looking at?

Because the .NET documentation and their Azure documentation are some of the best docs I've used and come across. Azure's doc certainly kick the crap out of GCP and AWS.

[–] candyman337@lemmy.world 2 points 1 year ago (1 children)

Their azure documentation is mostly surface level. They make all those docs like they're talking to a user not a dev. They're limited AF when you're actually trying to deploy an app via a ci/cd pipeline

Microsoft365 docks have several articles that are fully depreciated and there is no disclaimer at the top about switching to new security standards or anything like that.

That's just off the top of my head, but there have been plenty more I've had the displeasure of using

[–] masterspace@lemmy.ca 3 points 1 year ago

Their azure documentation is mostly surface level. They make all those docs like they’re talking to a user not a dev. They’re limited AF when you’re actually trying to deploy an app via a ci/cd pipeline

Deploy to what? I've had no issues deploying to App Service from both Github actions and Azure pipelines and azure functions / static web apps were even easier.

[–] vfsh@lemmy.blahaj.zone 15 points 1 year ago (1 children)

Microsoft docs in general are the worst. Can't tell you how many fucking dead links and straight up incorrect information I've come across on their official help articles

[–] candyman337@lemmy.world 9 points 1 year ago

Or deprecated documentation that has no indicator whatsoever that it's out of date

[–] SpaceNoodle@lemmy.world 8 points 1 year ago (1 children)

I see you've never dealt with chip vendors

[–] candyman337@lemmy.world 1 points 1 year ago

Thankfully not