** BC-BREAKING CHANGE ** - addresses #139 - makes OAuth2_Storage_UserCredentialsInterface::getUserDetails required to return user_id
attempts to standardize documentation a little better