diff --git a/reference/array/functions/array-rand.xml b/reference/array/functions/array-rand.xml
index 308c9e456..6aaf8d97b 100644
--- a/reference/array/functions/array-rand.xml
+++ b/reference/array/functions/array-rand.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4a1dedc24b1e085f298ab1d5dadefe306373691b Maintainer: shein Status: ready -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.array-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -18,6 +18,7 @@
    Для одного элемента возвращается ключ, а для нескольких элементов — массив ключей.
   </para>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
diff --git a/reference/array/functions/shuffle.xml b/reference/array/functions/shuffle.xml
index d59cf79bf..8b3ce01b4 100644
--- a/reference/array/functions/shuffle.xml
+++ b/reference/array/functions/shuffle.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f781803449007bb0e3a96c693e0eee067f7eb466 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.shuffle" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -16,6 +16,7 @@
    Функция перемешивает элементы массива в случайном порядке.
   </para>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -54,9 +55,9 @@
       <row>
        <entry>7.1.0</entry>
        <entry>
-        Внутренний алгоритм
-        получения случайных чисел <link linkend="migration71.incompatible.rand-srand-aliases">изменён</link> с функции rand библиотеки libc на генератор
-        на базе <link xlink:href="&url.mersenne;">Вихря Мерсена.</link>
+        Внутренний алгоритм генерации случайных чисел
+        <link linkend="migration71.incompatible.rand-srand-aliases">изменился</link> с функции rand библиотеки libc
+        на генератор на базе <link xlink:href="&url.mersenne;">Вихря Мерсе́на.</link>
        </entry>
       </row>
      </tbody>
@@ -69,16 +70,16 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Пример использования <function>shuffle</function></title>
+    <title>Пример перемешивания массива функцией <function>shuffle</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $numbers = range(1, 20);
 shuffle($numbers);
 foreach ($numbers as $number) {
     echo "$number ";
 }
-?>
 ]]>
     </programlisting>
    </example>
diff --git a/reference/random/functions/mt-rand.xml b/reference/random/functions/mt-rand.xml
index 34a87027b..a03811828 100644
--- a/reference/random/functions/mt-rand.xml
+++ b/reference/random/functions/mt-rand.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0a5e7b12546b62a611a0cbc7105e617ab96fbcbd Maintainer: sergey Status: ready -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.mt-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -36,6 +36,7 @@
    вернёт случайное число между 5 и 15 включительно.
   </simpara>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
  </refsect1>
 
  <refsect1 role="parameters">
@@ -98,7 +99,8 @@
       <row>
       <entry>8.0.0</entry>
       <entry>
-       Функция выбросит ошибку <classname>ValueError</classname>, если значение параметра <parameter>max</parameter> окажется меньше значения параметра <parameter>min</parameter>;
+       Функция выбросит ошибку <classname>ValueError</classname>,
+       если значение параметра <parameter>max</parameter> окажется меньше значения параметра <parameter>min</parameter>;
        раньше функция выдавала ошибку уровня <constant>E_WARNING</constant> и возвращала значение &false;.
       </entry>
      </row>
@@ -150,8 +152,6 @@ echo mt_rand(), "\n";
 echo mt_rand(), "\n";
 
 echo mt_rand(5, 15), "\n";
-
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;
diff --git a/reference/random/functions/rand.xml b/reference/random/functions/rand.xml
index bdf0891bf..c80bab324 100644
--- a/reference/random/functions/rand.xml
+++ b/reference/random/functions/rand.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a2a3f3525979535f7f8c81b79315391f2fdc285b Maintainer: sergey Status: ready -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.rand" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -24,6 +24,7 @@
    Вызов <literal>rand(5, 15)</literal> вернёт случайное число между 5 и 15 включительно.
   </simpara>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
   <note>
    <simpara>
     До PHP 7.1.0 на отдельных платформах наподобие Windows функция <function>getrandmax</function>
@@ -124,8 +125,6 @@ echo rand(), "\n";
 echo rand(), "\n";
 
 echo rand(5, 15), "\n";
-
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;
diff --git a/reference/strings/functions/str-shuffle.xml b/reference/strings/functions/str-shuffle.xml
index 31f24799b..7d3acfabd 100644
--- a/reference/strings/functions/str-shuffle.xml
+++ b/reference/strings/functions/str-shuffle.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 52c495140bdb84f45f186bfb1cccf09788b0121e Maintainer: shein Status: ready -->
+<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.str-shuffle" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -14,10 +14,11 @@
    <methodparam><type>string</type><parameter>string</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   <function>str_shuffle</function> перемешивает символы в строке.
-   Выбирается одна возможная перестановка из всех возможных.
+   Функция <function>str_shuffle</function> перемешивает символы в строке
+   путём случайной перестановки.
   </simpara>
   &caution.cryptographically-insecure;
+  &caution.mt19937-global-state;
  </refsect1>
 
  <refsect1 role="parameters">
@@ -39,7 +40,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает перемешанную строку.
+   Функция возвращает перемешанную строку.
   </para>
  </refsect1>
 
@@ -58,9 +59,9 @@
       <row>
        <entry>7.1.0</entry>
        <entry>
-        Внутренний алгоритм
-         получения случайных чисел <link linkend="migration71.incompatible.rand-srand-aliases">изменён</link> с функции rand библиотеки libc на генератор
-         на базе <link xlink:href="&url.mersenne;">Вихря Мерсена</link>.
+        Внутренний алгоритм генерации случайных чисел
+        <link linkend="migration71.incompatible.rand-srand-aliases">изменился</link> с функции rand библиотеки libc
+        на генератор на базе <link xlink:href="&url.mersenne;">Вихря Мерсе́на.</link>
        </entry>
       </row>
      </tbody>
@@ -73,16 +74,16 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Пример использования <function>str_shuffle</function></title>
+    <title>Пример перемешивания символов в строке функцией <function>str_shuffle</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $str = 'abcdef';
 $shuffled = str_shuffle($str);
 
-// выведет что-то вроде этого: bfdaec
+// Выведет что-то вроде: bfdaec
 echo $shuffled;
-?>
 ]]>
     </programlisting>
    </example>