Release v3.0.0-rc.2 🔖

Author: cabol

CHANGELOG.md

@@ -4,6 +4,44 @@ All notable changes to this project will be documented in this file.
 
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [v3.0.0-rc.2](https://github.com/elixir-nebulex/nebulex/tree/v3.0.0-rc.2) (2025-12-07)
+> [Full Changelog](https://github.com/elixir-nebulex/nebulex/compare/v3.0.0-rc.1...v3.0.0-rc.2)
+
+### Enhancements
+
+- [Nebulex.Cache] Added `:telemetry` option as a shared command option,
+  allowing selective override of the global telemetry setting on a per-command
+  basis without needing to start separate cache instances.
+- [Nebulex.Cache] Added `fetch_or_store` callback to the Cache API.
+  For more information, see:
+  [#240](https://github.com/elixir-nebulex/nebulex/issues/240).
+- [Nebulex.Cache] Added `get_or_store` callback to the Cache API.
+  For more information, see:
+  [#241](https://github.com/elixir-nebulex/nebulex/issues/241).
+- [Nebulex.Caching.Decorators] The `cache_evict` decorator now supports a
+  `:query` option for bulk eviction based on adapter-specific queries.
+  For example: `@decorate cache_evict(query: my_query)`. The query can be
+  provided directly or as a function that returns the query at runtime.
+  Additionally, both `:query` and `:key` options can be used together to
+  evict specific entries and entries matching a query pattern in a single
+  operation. When both are provided, query-based eviction executes first,
+  followed by key-based eviction.
+  For more information, see:
+  [#243](https://github.com/elixir-nebulex/nebulex/issues/243).
+  [#245](https://github.com/elixir-nebulex/nebulex/issues/245).
+- [Nebulex.Caching.Decorator] Add support for evicting external references in
+  `cache_evict` decorator. For more information, see:
+  [#244](https://github.com/elixir-nebulex/nebulex/issues/244)
+- [Documentation] Added comprehensive "Declarative Caching" guide
+  (`guides/learning/declarative-caching.md`) showcasing patterns, best
+  practices, and real-world examples for using caching decorators. The guide
+  includes progressive learning with an e-commerce scenario covering basic
+  decorator usage, advanced eviction patterns (including the new combined
+  `:key` and `:query` feature), `Nebulex.Adapters.Local` features
+  (QueryHelper, tagging, references), testing strategies, and common pitfalls.
+  Replaces ad-hoc examples previously scattered in API documentation.
+  [#246](https://github.com/elixir-nebulex/nebulex/issues/246).
+
 ## [v3.0.0-rc.1](https://github.com/elixir-nebulex/nebulex/tree/v3.0.0-rc.1) (2025-05-01)
 > [Full Changelog](https://github.com/elixir-nebulex/nebulex/compare/v2.6.4...v3.0.0-rc.1)
 

README.md

@@ -67,10 +67,10 @@ For example, to use the Generational Local Cache
 ```elixir
 def deps do
   [
-    {:nebulex, "~> 3.0.0-rc.1"},
-    {:nebulex_local, "~> 3.0.0-rc.1"}, # Generational local cache adapter
+    {:nebulex, "~> 3.0.0-rc.2"},
+    {:nebulex_local, "~> 3.0.0-rc.2"}, # Generational local cache adapter
     {:decorator, "~> 1.4"},            # Required for caching decorators
-    {:telemetry, "~> 1.2"}             # Required for telemetry events
+    {:telemetry, "~> 1.3"}             # Required for telemetry events
   ]
 end
 ```