docs: it's args and kwargs

Author: hynek

.github/CONTRIBUTING.md

@@ -113,7 +113,7 @@ But it's way more comfortable to run it locally and *git* catching avoidable err
       """
       Do something.
 
-      Parameters:
+      Args:
           x: A very important parameter.
 
           y:

src/argon2/_password_hasher.py

@@ -40,7 +40,7 @@ class PasswordHasher:
     parameters and to verify the parameters only *once*.  Any unnecessary
     slowdown when hashing is a tangible advantage for a brute-force attacker.
 
-    Parameters:
+    Args:
         time_cost:
             Defines the amount of computation realized and therefore the
             execution time, given in number of iterations.
@@ -162,10 +162,11 @@ def hash(self, password: str | bytes, *, salt: bytes | None = None) -> str:
         """
         Hash *password* and return an encoded hash.
 
-        Parameters:
+        Args:
             password: Password to hash.
 
-            salt: If None, a random salt is securely created.
+            salt:
+                If None, a random salt is securely created.
 
                 .. danger::
 
@@ -208,7 +209,7 @@ def verify(
             other parsing than the determination of the hash type is done by
             *argon2-cffi*.
 
-        Parameters:
+        Args:
             hash: An encoded hash as returned from :meth:`PasswordHasher.hash`.
 
             password: The password to verify.
@@ -256,7 +257,7 @@ def check_needs_rehash(self, hash: str) -> bool:
         Therefore it's best practice to check -- and if necessary rehash --
         passwords after each successful authentication.
 
-        Parameters:
+        Args:
             hash: An encoded Argon2 password hash.
 
         Returns:

src/argon2/_utils.py

@@ -103,7 +103,7 @@ def extract_parameters(hash: str) -> Parameters:
     """
     Extract parameters from an encoded *hash*.
 
-    Parameters:
+    Args:
         hash: An encoded Argon2 hash string.
 
     Returns:

src/argon2/low_level.py

@@ -66,11 +66,10 @@ def hash_secret(
     An encoded hash can be directly passed into :func:`verify_secret` as it
     contains all parameters and the salt.
 
-    Parameters:
+    Args:
         secret: Secret to hash.
 
-        salt:
-            A salt_.  Should be random and different for each secret.
+        salt: A salt_. Should be random and different for each secret.
 
         type: Which Argon2 variant to use.
 
@@ -166,7 +165,7 @@ def verify_secret(hash: bytes, secret: bytes, type: Type) -> Literal[True]:
     """
     Verify whether *secret* is correct for *hash* of *type*.
 
-    Parameters:
+    Args:
         hash:
             An encoded Argon2 hash as returned by :func:`hash_secret`.
 
@@ -179,6 +178,7 @@ def verify_secret(hash: bytes, secret: bytes, type: Type) -> Literal[True]:
         argon2.exceptions.VerifyMismatchError:
             If verification fails because *hash* is not valid for *secret* of
             *type*.
+
         argon2.exceptions.VerificationError:
             If verification fails for other reasons.
 
@@ -221,7 +221,7 @@ def core(context: Any, type: int) -> int:
         Use at your own peril; *argon2-cffi* does *not* use this binding
         itself.
 
-    Parameters:
+    Args:
         context:
             A CFFI Argon2 context object (i.e. an ``struct Argon2_Context`` /
             ``argon2_context``).
@@ -243,7 +243,7 @@ def error_to_str(error: int) -> str:
     """
     Convert an Argon2 error code into a native string.
 
-    Parameters:
+    Args:
         error: An Argon2 error code as returned by :func:`core`.
 
     Returns: