refactor(decryption): ✨ Improve docstring for `decrypt_security_token` function

- Enhanced clarity of the function's purpose and usage.
- Added detailed descriptions for arguments and return values.

1 files changed, 10 insertions, 2 deletions

diff --git a/tidal_dl_ng/helper/decryption.py b/tidal_dl_ng/helper/decryption.py
index 17ea19b..2f38fc5 100644
--- a/tidal_dl_ng/helper/decryption.py
+++ b/tidal_dl_ng/helper/decryption.py
@@ -7,9 +7,17 @@ from Crypto.Util import Counter
 
 def decrypt_security_token(security_token: str) -> (str, str):
     """
-    Decrypts security token into key and nonce pair
+    The `decrypt_security_token` function decrypts a security token into a key and nonce pair using AES
+    encryption.
 
-    security_token should match the securityToken value from the web response
+    Args:
+      security_token (str): The `security_token` parameter in the `decrypt_security_token` function is a
+    string that represents an encrypted security token. This function decrypts the security token into a
+    key and nonce pair using AES encryption. security_token should match the securityToken value from the web response.
+
+    Returns:
+      The `decrypt_security_token` function returns a tuple containing the key and nonce extracted from
+    the decrypted security token.
     """
 
     # Do not change this