I despise the programmer's hubris around the concept of self-documenting things especially as I'm running into so many examples of programmers who don't actually sit down and read library code these days. And especially despise apologist management that make excuses for them.
We didn't get where we are by not writing manuals and knowing what we're doing under the hood. Abstraction is fine once you're actually aware of what you're boundary conditions are.
That's probably true after you are comfortable in it, but as someone trying to wrangle it for the first time it was rather mystifying for anything outside of trivial usecases.
It's graphql, it's self-documenting.