Updated ** replacement suggestion

Author: paxnovem

doc/migrations.rst

@@ -12,14 +12,17 @@ Migrating between versions
 
 .. _migrating_6x_7x:
 
-Migrating 6.x.x — 7.x.x
+Migrating 6.5.x — 7.0.x
 --------------------------
 - The way that wildcards when specifing file paths work in certain caseshas changed in 7.x:
 
   - Previously, ``*`` would incorrectly match directory separators, making
     precise matching difficult. This requires ``[paths]`` such as ``*tests/*``
     to be changed to ``*/tests/*``.
 
+  - ``**`` now matches any number of nested directories. If you wish to retain the behavior of
+  ``**/tests/*`` in previous versions then  ``*/**/tests/*`` can be used instead.
+
 - When remapping file paths with ``[paths]``, a path will be remapped only if
   the resulting path exists. Ensure that remapped ``[paths]`` exist when upgrading
   as this is now being enforced.