Documentation tends to be "you take what you can get" on both sides. Are you going to turn down a PR because there aren't supporting docs? That's a good way to drive off developers too.
Generally someone who is annoyed with having to figure it out is the one who writes the documentation.
I just found a Matt Stoller article that has a bit different, but compatible, take on the same thing. You can scroll down to the "counterfeit capitalism" heading.