Updates API docs. Removes oauth2:authorize_resource_owner/3. 

I have rewritten the API functions' documentation to be more specific about the use case of each of them. I couldn't find the purpose of oauth2:authorize_resource_owner/3 so I removed it.
**This change breaks the compatibility with any implementation using the removed oauth2:authorize_resource_owner/3**.