Bardioc1977 · Bardioc1977 · Aug 6, 2026 · Aug 6, 2026 · Aug 6, 2026 · Aug 6, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.de.md b/README.de.md
diff --git a/README.md b/README.md
diff --git a/branding/brand-board.png b/branding/brand-board.png
diff --git a/branding/brand-board.svg b/branding/brand-board.svg
diff --git a/branding/morphium-logo-dark.svg b/branding/morphium-logo-dark.svg
diff --git a/branding/morphium-logo.png b/branding/morphium-logo.png
diff --git a/branding/morphium-logo.svg b/branding/morphium-logo.svg
diff --git a/branding/morphium-mark.png b/branding/morphium-mark.png
diff --git a/branding/morphium-mark.svg b/branding/morphium-mark.svg
diff --git a/branding/poppydb-logo-dark.svg b/branding/poppydb-logo-dark.svg
diff --git a/branding/poppydb-logo.png b/branding/poppydb-logo.png
diff --git a/branding/poppydb-logo.svg b/branding/poppydb-logo.svg
diff --git a/branding/poppydb-mark.png b/branding/poppydb-mark.png
diff --git a/branding/poppydb-mark.svg b/branding/poppydb-mark.svg
diff --git a/docs/architecture-overview.md b/docs/architecture-overview.md
@@ -161,10 +161,12 @@ Aggregator<Order, OrderStats> agg = morphium.createAggregator(Order.class, Order
 
 #### Cache Synchronization
 **Cluster-aware caching** with synchronization:
-- **WatchingCacheSynchronizer** - Uses MongoDB Change Streams
-- **MessagingCacheSynchronizer** - Uses Morphium messaging
+- **WatchingCacheSynchronizer** - Watches the underlying collections via MongoDB Change Streams; catches changes from any writer (not just Morphium), but needs a replica set
+- **MessagingCacheSynchronizer** - Propagates invalidations via Morphium's own messaging; works on any backend (no replica set needed), but only sees writes made through Morphium
 - **Manual cache control** for custom strategies
 
+See [Developer Guide § Cache Synchronization](./developer-guide.md#cache-synchronization) for guidance on choosing between them.
+
 #### Cache Strategies
 ```java
 @Cache(

diff --git a/docs/assets/brand/morphium-logo-dark.svg b/docs/assets/brand/morphium-logo-dark.svg
diff --git a/docs/assets/brand/morphium-logo.svg b/docs/assets/brand/morphium-logo.svg
diff --git a/docs/assets/brand/morphium-mark-header.svg b/docs/assets/brand/morphium-mark-header.svg
diff --git a/docs/assets/brand/morphium-mark.svg b/docs/assets/brand/morphium-mark.svg
diff --git a/docs/assets/brand/poppydb-logo-dark.svg b/docs/assets/brand/poppydb-logo-dark.svg
diff --git a/docs/assets/brand/poppydb-logo.svg b/docs/assets/brand/poppydb-logo.svg
diff --git a/docs/assets/brand/poppydb-mark.svg b/docs/assets/brand/poppydb-mark.svg
diff --git a/docs/assets/extra.css b/docs/assets/extra.css
@@ -0,0 +1,13 @@
+/* Swap brand logos with the Material color scheme toggle.
+   Two <img> tags are emitted per logo; exactly one is visible per scheme. */
+.logo-dark {
+  display: none;
+}
+
+[data-md-color-scheme="slate"] .logo-light {
+  display: none;
+}
+
+[data-md-color-scheme="slate"] .logo-dark {
+  display: inline;
+}