Merge pull request #8877 from kenjis/docs-config-caching-add-notes

docs: add notes for Config Caching

Author: kenjis

user_guide_src/source/concepts/factories.rst

@@ -270,6 +270,10 @@ Config Caching
 
 .. versionadded:: 4.4.0
 
+.. important:: Do not use this feature unless you have carefully read this section
+    and understand how this feature works. Otherwise, your application will not
+    function properly.
+
 To improve performance, Config Caching has been implemented.
 
 Prerequisite
@@ -287,6 +291,9 @@ Prerequisite
 How It Works
 ============
 
+.. important:: Once cached, configuration values are never changed until the cache
+    is deleted, even if the configuration file or **.env** is changed.
+
 - Save the all Config instances in Factories into a cache file before shutdown,
   if the state of the Config instances in Factories changes.
 - Restore cached Config instances before CodeIgniter initialization if a cache

user_guide_src/source/installation/deployment.rst

@@ -56,6 +56,9 @@ See :ref:`modules-specify-composer-packages`.
 Config Caching
 ==============
 
+.. important:: Once cached, configuration values are never changed until the cache
+    is deleted, even if the configuration file or **.env** is changed.
+
 Caching the Config objects can improve performance. However, the cache must be
 manually deleted when changing Config values.