Documentation updated

Author: intellinside

README.md

@@ -286,13 +286,14 @@ This project is licensed under the MIT License. See the [LICENSE](LICENSE) file
 
 ## Changelog
 
+### Version 0.2.0
+- Added TTL support for Redis backend
+- Added support for Spring Template Expression syntax (#{...})
+
+
 ### Version 0.1.0
 - Initial release
 - Support for @CacheTags and @EvictTags annotations
 - In-Memory and Redis storage backends
 - Full Spring Boot auto-configuration
 - Complete JavaDoc documentation
-
-### Version 0.2.0
-- Added TTL support for Redis backend
-- Added support for Spring Template Expression syntax (#{...})

spring-cache-tags-redis/src/main/java/io/github/intellinside/cache/tags/store/RedisCacheTagStore.java

@@ -14,35 +14,28 @@
  * Redis-based implementation of {@link CacheTagsStore}.
  *
  * <p>
- * This implementation stores tag-to-key mappings in Redis using Redis Sets.
- * It is suitable for distributed systems, clustered deployments, or scenarios
- * where
- * tag associations need to be shared across multiple application instances.
+ * This implementation stores tag-to-key mappings in Redis using Redis Sets
+ * (one Redis Set per tag). It is intended for distributed or clustered
+ * deployments where tag associations must be shared between application
+ * instances.
+ * </p>
  *
  * <p>
- * <b>Features:</b>
+ * <b>Behavior and guarantees</b>:
  * <ul>
- * <li>Distributed tag mappings across multiple instances</li>
- * <li>Automatic data persistence</li>
- * <li>Thread-safe operations through Redis</li>
- * <li>Suitable for high-concurrency environments</li>
+ * <li>Associations are stored in Redis Sets (atomic, concurrent-safe on the
+ * Redis side).</li>
+ * <li>Entries are stored as strings in the format {@code {cacheName}:{key}},
+ * where {@code key} is obtained via {@code toString()} on the provided key
+ * object.</li>
+ * <li>TTL (expiration) is applied per-tag when the configured
+ * {@code RedisCacheConfiguration#getTtlFunction()} returns a positive
+ * {@code Duration} for the tag. TTL is set using {@code RedisTemplate.expire}.
+ * </li>
+ * <li>Methods are null-tolerant: missing Redis Set members produce no entries
+ * and the lookup returns an empty map when no associations are found.</li>
  * </ul>
- *
- * <p>
- * <b>Redis Data Structure:</b>
- * <ul>
- * <li>Keys: "tag:{tagName}" (Redis Set)</li>
- * <li>Values: "{cacheName}:{key}" (serialized cache references)</li>
- * </ul>
- *
- * <p>
- * <b>Example:</b>
- *
- * <pre>
- * SET tag:user:123 user-cache:123:details
- * SET tag:user:123 user-cache:123:permissions
- * SET tag:type:admin admin-cache:456:settings
- * </pre>
+ * </p>
  *
  * @author intellinside
  * @see CacheTagsStore

spring-cache-tags/src/main/java/io/github/intellinside/cache/tags/annotation/SpelExpressionEvaluator.java

@@ -31,10 +31,12 @@
  * <b>Example expressions:</b>
  *
  * <pre>
- * \"'user:' + #userId\"           // Concatenates literal with argument
- * \"'result:' + #result.id\"       // Uses property of returned object
- * \"'cache:' + #args[0]\"          // Uses first argument
- * \"#result.type.toString()\"      // Calls methods on result
+ * "'user:' + #userId"                // Concatenates a literal with a named parameter
+ * "'result:' + #result.id"           // Uses a property of the returned object
+ * "'cache:' + #args[0]"              // Uses the first argument from the #args array
+ * "#result?.type?.toString()"        // Safe navigation to avoid NPE when result is null
+ * "#method.name"                      // Access method metadata (name, declaringType, etc.)
+ * "User: #{#userId}"                  // Template-style expression (uses TemplateParserContext)
  * </pre>
  *
  * <p>