docs: align README files with codebase limits

Added the literal integer limit next to references of MAX_LOCK_KEY_LENGTH to improve readability while avoiding changes to exact Javadoc samples that reflect actual source files.

Co-authored-by: pmalirz <19637300+pmalirz@users.noreply.github.com>

Author: google-labs-jules[bot]

README.md

@@ -192,7 +192,7 @@ sequenceDiagram
 
 When using the `KeyLock` API, keep the following constraints in mind:
 
-* **`lockKey`** must be a non-blank string, up to `KeyLock.MAX_LOCK_KEY_LENGTH` characters (the database column limit). `SimpleKeyLock.tryLock` enforces this by throwing an `IllegalArgumentException`.
+* **`lockKey`** must be a non-blank string, up to `KeyLock.MAX_LOCK_KEY_LENGTH` (1000) characters (the database column limit). `SimpleKeyLock.tryLock` enforces this by throwing an `IllegalArgumentException`.
 * **`expirationSeconds`** must be greater than 0. `SimpleKeyLock.tryLock` enforces this by throwing an `IllegalArgumentException`.
 * **Lock keys should be descriptive and scoped** (e.g., `"/invoice/{id}"`) to avoid unintended collisions.
 * **`unlock`** operations with a `null` `LockHandle` are safely ignored by `SimpleKeyLock.unlock`.

dlock-core/README.md

@@ -4,7 +4,7 @@ This module contains the core implementation logic for **dlock**, independent of
 
 ## Components
 
-* **SimpleKeyLock**: The main implementation of `KeyLock` interface. It orchestrates the locking process using a `LockRepository`. It enforces basic API constraints for `lockKey` (non-blank, max `KeyLock.MAX_LOCK_KEY_LENGTH` characters) and `expirationSeconds` (greater than 0) by throwing an `IllegalArgumentException`. The `unlock` method safely handles `null` handles without throwing errors.
+* **SimpleKeyLock**: The main implementation of `KeyLock` interface. It orchestrates the locking process using a `LockRepository`. It enforces basic API constraints for `lockKey` (non-blank, max `KeyLock.MAX_LOCK_KEY_LENGTH` (1000) characters) and `expirationSeconds` (greater than 0) by throwing an `IllegalArgumentException`. The `unlock` method safely handles `null` handles without throwing errors.
 * **SimpleLocalKeyLock**: A convenient subclass of `SimpleKeyLock` pre-configured with `LocalLockRepository` (in-memory) and default settings. Useful for testing or single-instance applications.
 * **LockRepository**: Interface for storage backends (e.g., `JDBCLockRepository` implements this).
 * **LockExpirationPolicy**: Strategy for handling lock expiration. Defaults to `LocalLockExpirationPolicy`.