docs: it's args and kwargs

.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: