Merge pull request #7975 from cakephp/text-insert

Add info about Text::insert() change.

Author: ADmad

en/appendices/6-0-migration-guide.rst

@@ -16,3 +16,9 @@ Behavior Changes
   ``JsonType`` by default.
 - ``Cake\View\Widget\FileWidget`` was removed as it was redundant. The standard
   input widget will be used for file inputs in 6.x.
+
+Breaking Changes
+================
+- The default placeholder format for ``Text::insert()`` has been changed.
+  They now use ``{foo}`` instead of ``:foo``. You can get the old
+  behavior by using the ``before`` and ``after`` keys of ``$options``.

en/appendices/migration-guides.rst

@@ -11,4 +11,5 @@ each version and the migration path between 5.x minor releases.
     ./5-0-migration-guide
     ./5-1-migration-guide
     ./5-2-migration-guide
+    ./6-0-migration-guide
     ./phpunit10

en/core-libraries/text.rst

@@ -129,18 +129,18 @@ The insert method is used to create string templates and to allow for key/value
 replacements::
 
     Text::insert(
-        'My name is :name and I am :age years old.',
+        'My name is {name} and I am {age} years old.',
         ['name' => 'Bob', 'age' => '65']
     );
     // Returns: "My name is Bob and I am 65 years old."
 
 .. php:staticmethod:: cleanInsert($string, $options = [])
 
-Cleans up a ``Text::insert`` formatted string with given ``$options`` depending
+Cleans up a ``Text::insert()`` formatted string with given ``$options`` depending
 on the 'clean' key in ``$options``. The default method used is text but html is
 also available. The goal of this function is to replace all whitespace and
 unneeded markup around placeholders that did not get replaced by
-``Text::insert``.
+``Text::insert()``.
 
 You can use the following options in the options array::