this post was submitted on 22 Jun 2024
809 points (98.7% liked)
Programmer Humor
32361 readers
357 users here now
Post funny things about programming here! (Or just rant about your favourite programming language.)
Rules:
- Posts must be relevant to programming, programmers, or computer science.
- No NSFW content.
- Jokes must be in good taste. No hate speech, bigotry, etc.
founded 5 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
If I had a cookie for every time someone asked me if I could pull together some obscure metric during a 30 minute meeting I’d have the beetus
Same. Especially since I've been building EDWs for most of my career. People are always surprised that it actually takes time to integrate with different systems.
"What do you mean you can't just pull all the data out of this system that we don't have database access to and are still building out the APIs?"
I kid... The people asking for stuff don't know what backend databases and APIs are.
I mean without documentation… what is an API?
Maybe this makes me old, but I much prefer a written document explaining how an API works over Swagger.
I prefer a hybrid approach. A document explaining some common things to do and generally the idea behind why the API is structured that way (shows me you actually thought about it, and makes it more logical to find different parts of it without necessarily looking it up), and then an API spec showing all the parameters.