From b8cd2aeb494e0df7a979c9113671d01b53254586 Mon Sep 17 00:00:00 2001
From: Mark Story <mark@mark-story.com>
Date: Mon, 24 Jun 2024 00:30:56 -0400
Subject: [PATCH] Add docs notes for cakephp/cakephp#17714

---
 en/appendices/5-1-migration-guide.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/en/appendices/5-1-migration-guide.rst b/en/appendices/5-1-migration-guide.rst
index e39823474f..b43caca714 100644
--- a/en/appendices/5-1-migration-guide.rst
+++ b/en/appendices/5-1-migration-guide.rst
@@ -26,6 +26,10 @@ Behavior Changes
   name is already added.
 - ``TestCase::loadPlugins()`` will now clear out any previously loaded plugins. So
   you must specify all plugins required for any subsequent tests.
+- The hashing algorithm for ``Cache`` configurations that use ``groups``. Any
+  keys will have new group prefix hashes generated which will cause cache
+  misses. Consider an incremental deploy to avoid operating on an entirely cold
+  cache.
 
 Deprecations
 ============