Add documentation about sync-only methods. (#357)

Author: mattgd

workos/sso.py

@@ -61,6 +61,8 @@ def get_authorization_url(
         The URL generated will redirect a User to the Identity Provider configured through
         WorkOS.
 
+        This method is purposefully designed as synchronous as it does not make any HTTP requests.
+
         Kwargs:
             redirect_uri (str) : A valid redirect URI, as specified on WorkOS
             state (str) : An encoded string passed to WorkOS that'd be preserved through the authentication workflow, passed

workos/user_management.py

@@ -331,6 +331,8 @@ def get_authorization_url(
         The URL generated will redirect a User to the Identity Provider configured through
         WorkOS.
 
+        This method is purposefully designed as synchronous as it does not make any HTTP requests.
+
         Kwargs:
             redirect_uri (str): A Redirect URI to return an authorized user to.
             connection_id (str): The connection_id connection selector is used to initiate SSO for a Connection.
@@ -546,6 +548,8 @@ def authenticate_with_refresh_token(
     def get_jwks_url(self) -> str:
         """Get the public key that is used for verifying access tokens.
 
+        This method is purposefully designed as synchronous as it does not make any HTTP requests.
+
         Returns:
             (str): The public JWKS URL.
         """
@@ -555,6 +559,8 @@ def get_jwks_url(self) -> str:
     def get_logout_url(self, session_id: str) -> str:
         """Get the URL for ending the session and redirecting the user
 
+        This method is purposefully designed as synchronous as it does not make any HTTP requests.
+
         Args:
             session_id (str): The ID of the user's session