I just recently was impressed by how nice looking their docs are and confused by how bad they are at actually explaining what to do with it, so I can certainly

I just recently was impressed by how nice looking their docs are and confused by how bad they are at actually explaining what to do with it, so I can certainly relate. I think what they really need is to figure out what calls people make most often and mark those very clearly at the top, along with a human-readable description. Like for example "HERE'S THE CALL YOU CAN USE TO GET A USER'S TWEETS', or 'HERE'S THE ONE YOU USE TO GET TWEETS ABOUT WORD OR HASHTAG X' -- Isn't this the case for everything?