this post was submitted on 22 Jun 2024
815 points (98.7% liked)
Programmer Humor
32464 readers
453 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
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.