Apply suggestions from code review

Co-authored-by: Rita Zerrizuela <zeta@widcket.com>

Author: adamjmcgrath

EXAMPLES.md

@@ -2,7 +2,7 @@
 
 - [Authentication SDK](#authentication-sdk)
   - [ID token validation](#id-token-validation)
-  - [Authenticating with a application configured to use `private_key_jwt` token endpoint auth method.](#authenticating-with-a-application-configured-to-use-private-key-jwt-token-endpoint-auth-method)
+  - [Authenticating with a application configured to use `private_key_jwt` token endpoint auth method](#authenticating-with-a-application-configured-to-use-private-key-jwt-token-endpoint-auth-method)
 - [Management SDK](#management-sdk)
   - [Connections](#connections)
   - [Error handling](#error-handling)
@@ -50,7 +50,7 @@ tv.verify(id_token)
 
 If the token verification fails, a `TokenValidationError` will be raised. In that scenario, the ID token should be deemed invalid and its contents should not be trusted.
 
-### Authenticating with a application configured to use `private_key_jwt` token endpoint auth method.
+### Authenticating with a application configured to use `private_key_jwt` token endpoint auth method
 
 ```python
 from auth0.v3.authentication import GetToken
@@ -63,12 +63,12 @@ MIIJKQIBAAKCAgEAwfUb0nUC0aKB3WiytFhnCIg455BYC+dR3MUGadWpIg7S6lbi
 """
 
 get_token = GetToken(
-    "my-domain.auth0.com",
+    "my-domain.us.auth0.com",
     "my-client-id",
     client_assertion_signing_key=private_key,
 )
 token = get_token.client_credentials(
-    "https://my-domain.auth0.com/api/v2/"
+    "https://my-domain.us.auth0.com/api/v2/"
 )
 ```
 

README.md

@@ -38,7 +38,7 @@ For example:
 ```python
 from auth0.v3.authentication import Social
 
-social = Social('myaccount.auth0.com', 'my-client-id')
+social = Social('my-domain.us.auth0.com', 'my-client-id')
 
 social.login(access_token='...', connection='facebook')
 ```
@@ -48,7 +48,7 @@ If you need to sign up a user using their email and password, you can use the Da
 ```python
 from auth0.v3.authentication import Database
 
-database = Database('myaccount.auth0.com', 'my-client-id')
+database = Database('my-domain.us.auth0.com', 'my-client-id')
 
 database.signup(email='user@domain.com', password='secr3t', connection='Username-Password-Authentication')
 ```
@@ -58,7 +58,7 @@ If you need to authenticate a user using their email and password, you can use t
 ```python
 from auth0.v3.authentication import GetToken
 
-token = GetToken('myaccount.auth0.com', 'my-client-id', client_secret='my-client-secret')
+token = GetToken('my-domain.us.auth0.com', 'my-client-id', client_secret='my-client-secret')
 
 token.login(username='user@domain.com', password='secr3t', realm='Username-Password-Authentication')
 ```

V4_MIGRATION_GUIDE.md

@@ -3,21 +3,21 @@
 Guide to migrating from `3.x` to `4.x`
 
 - [Python <3.6 is no longer supported](#python-36-is-no-longer-supported)
-- [Client ID and Client Secret are now specified in the constructor for Authentication Clients](#client-id-and-client-secret-are-now-specified-in-the-constructor-for-authentication-clients)
+- [Client ID and client secret are now specified in the constructor for authentication clients](#client-id-and-client-secret-are-now-specified-in-the-constructor-for-authentication-clients)
 - [AuthorizeClient and Logout have been removed](#authorizeclient-and-logout-have-been-removed)
 
 ## Python <3.6 is no longer supported
 
 Python 3.5 and Python 2 are EOL and are no longer supported. 
 
-## Client ID and Client Secret are now specified in the constructor for Authentication Clients
+## Client ID and client secret are now specified in the constructor for authentication clients
 
 ### Before
 
 ```py
 from auth0.v3.authentication import GetToken
 
-get_token = GetToken('myaccount.auth0.com')
+get_token = GetToken('my-domain.us.auth0.com')
 
 get_token.client_credentials('my-client-id', 'my-client-secret', 'my-api')
 ```
@@ -28,7 +28,7 @@ get_token.client_credentials('my-client-id', 'my-client-secret', 'my-api')
 from auth0.v3.authentication import GetToken
 
 # `client_secret` is optional (you can now use `client_assertion_signing_key` as an alternative) 
-get_token = GetToken('myaccount.auth0.com', 'my-client-id', client_secret='my-client-secret')
+get_token = GetToken('my-domain.us.auth0.com', 'my-client-id', client_secret='my-client-secret')
 
 get_token.client_credentials('my-api')
 ```

auth0/v3/authentication/base.py

@@ -17,12 +17,12 @@ class AuthenticationBase(object):
     """Base authentication object providing simple REST methods.
 
     Args:
-        domain (str): The domain of your auth0 tenant
-        client_id (str): your application's client Id
-        client_secret (str, optional): your application's client Secret
+        domain (str): The domain of your Auth0 tenant
+        client_id (str): Your application's client ID
+        client_secret (str, optional): Your application's client secret
         client_assertion_signing_key (str, optional): Private key used to sign the client assertion JWT.
-        client_assertion_signing_alg (str, optional): Algorithm used to sign the client assertion JWT (Default RS256).
-        telemetry (bool, optional): Enable or disable Telemetry (defaults to True)
+        client_assertion_signing_alg (str, optional): Algorithm used to sign the client assertion JWT (defaults to 'RS256').
+        telemetry (bool, optional): Enable or disable telemetry (defaults to True)
         timeout (float or tuple, optional): Change the requests connect and read timeout. Pass a tuple to specify both values separately or a float to set both to it. (defaults to 5.0 for both)
         protocol (str, optional): Useful for testing. (defaults to 'https')
     """

auth0/v3/authentication/client_authentication.py

@@ -10,10 +10,10 @@ def create_client_assertion_jwt(
     """Creates a JWT for the client_assertion field.
 
     Args:
-        domain (str): The domain of your auth0 tenant
-        client_id (str): your application's client Id
+        domain (str): The domain of your Auth0 tenant
+        client_id (str): Your application's client ID
         client_assertion_signing_key (str, optional): Private key used to sign the client assertion JWT
-        client_assertion_signing_alg (str, optional): Algorithm used to sign the client assertion JWT (Default RS256)
+        client_assertion_signing_alg (str, optional): Algorithm used to sign the client assertion JWT (defaults to 'RS256')
 
     Returns:
         A JWT signed with the `client_assertion_signing_key`.
@@ -46,11 +46,11 @@ def add_client_authentication(
 
     Args:
         payload (dict): The POST payload that needs additional fields to be authenticated.
-        domain (str): The domain of your auth0 tenant
-        client_id (str): your application's client Id
-        client_secret (str): your application's client secret
+        domain (str): The domain of your Auth0 tenant
+        client_id (str): Your application's client ID
+        client_secret (str): Your application's client secret
         client_assertion_signing_key (str, optional): Private key used to sign the client assertion JWT
-        client_assertion_signing_alg (str, optional): Algorithm used to sign the client assertion JWT (Default RS256)
+        client_assertion_signing_alg (str, optional): Algorithm used to sign the client assertion JWT (defaults to 'RS256')
 
     Returns:
         A copy of the payload with client authentication fields added.

auth0/v3/authentication/enterprise.py

@@ -6,7 +6,7 @@ class Enterprise(AuthenticationBase):
     """Enterprise endpoints.
 
     Args:
-        domain (str): Your auth0 domain (e.g: username.auth0.com)
+        domain (str): Your auth0 domain (e.g: my-domain.us.auth0.com)
     """
 
     def saml_metadata(self):

auth0/v3/authentication/passwordless.py

@@ -8,7 +8,7 @@ class Passwordless(AuthenticationBase):
     """Passwordless connections endpoints.
 
     Args:
-        domain (str): Your auth0 domain (e.g: username.auth0.com)
+        domain (str): Your auth0 domain (e.g: my-domain.us.auth0.com)
     """
 
     def email(self, email, send="link", auth_params=None):

auth0/v3/authentication/revoke_token.py

@@ -5,7 +5,7 @@ class RevokeToken(AuthenticationBase):
     """Revoke Refresh Token endpoint
 
     Args:
-        domain (str): Your auth0 domain (e.g: username.auth0.com)
+        domain (str): Your auth0 domain (e.g: my-domain.us.auth0.com)
     """
 
     def revoke_refresh_token(self, token):

auth0/v3/authentication/social.py

@@ -6,7 +6,7 @@ class Social(AuthenticationBase):
     """Social provider's endpoints.
 
     Args:
-        domain (str): Your auth0 domain (e.g: username.auth0.com)
+        domain (str): Your auth0 domain (e.g: my-domain.us.auth0.com)
     """
 
     def login(self, access_token, connection, scope="openid"):

auth0/v3/authentication/users.py

@@ -9,8 +9,8 @@ class Users(object):
     """Users client.
 
     Args:
-        domain (str): The domain of your auth0 tenant
-        telemetry (bool, optional): Enable or disable Telemetry (defaults to True)
+        domain (str): The domain of your Auth0 tenant
+        telemetry (bool, optional): Enable or disable telemetry (defaults to True)
         timeout (float or tuple, optional): Change the requests connect and read timeout. Pass a tuple to specify both values separately or a float to set both to it. (defaults to 5.0 for both)
         protocol (str, optional): Useful for testing. (defaults to 'https')
     """