Merge pull request #8378 from BayoNet/l10n/DOCAPI-6182-flatten

DOCS-6182: arrayFlatten docs EN review and RU translation

docs/en/query_language/functions/array_functions.md

@@ -794,14 +794,11 @@ Synonym for ["arrayReverse"](#array_functions-arrayreverse)
 
 ## arrayFlatten {#arrayflatten}
 
-Converts array of arrays to a flat array.
+Converts an array of arrays to a flat array.
 
 Function:
 
-- Applies for any depth of nested arrays, but all the elements should lay at the same level.
-
-    For example, the `[[[1]], [[2], [3]]]` array can be flattened, but the `[[1], [[2], [3]]]` array can't be flattened.
-
+- Applies to any depth of nested arrays.
 - Does not change arrays that are already flat.
 
 The flattened array contains all the elements from all source arrays.

docs/ru/query_language/functions/array_functions.md

@@ -778,22 +778,6 @@ SELECT arrayReduce('uniqUpTo(3)', [1, 2, 3, 4, 5, 6, 7, 8, 9, 10])
 └─────────────────────────────────────────────────────────────┘
 ```
 
-## arrayFlatten(arr) {#array_functions-arrayflatten}
-
-Функция `arrayFlatten` (или `flatten`) соеденит вложенные массивы и вернет массив из их элементов.
-
-Пример:
-
-```sql
-SELECT arrayFlatten([[1, 2, 3], [4, 5]])
-```
-
-```text
-┌─arrayFlatten([[1, 2, 3], [4, 5]])─┐
-│                       [1,2,3,4,5] │
-└───────────────────────────────────┘
-```
-
 ## arrayReverse(arr) {#array_functions-arrayreverse}
 
 Возвращает массив того же размера, что и исходный массив, содержащий элементы в обратном порядке.
@@ -814,6 +798,41 @@ SELECT arrayReverse([1, 2, 3])
 Синоним для ["arrayReverse"](#array_functions-arrayreverse)
 
 
+## arrayFlatten {#arrayflatten}
+
+Преобразует массив массивов в плоский массив.
+
+Функция:
+
+- Оперирует с массивами любой вложенности.
+- Не изменяет массив, если он уже плоский.
+
+Результирующий массив содержит все элементы исходных массивов.
+
+**Синтаксис** 
+
+```sql
+flatten(array_of_arrays)
+```
+
+Синоним: `flatten`.
+
+
+**Параметры**
+
+- `array_of_arrays` — [Массивов](../../data_types/array.md) массивов. Например, `[[1,2,3], [4,5]]`.
+
+**Примеры**
+
+```sql
+SELECT flatten([[[1]], [[2], [3]]])
+```
+```text
+┌─flatten(array(array([1]), array([2], [3])))─┐
+│ [1,2,3]                                     │
+└─────────────────────────────────────────────┘
+```
+
 ## arrayCompact {#arraycompact}
 
 Удаляет дубликаты из массива. Порядок результирующих значений определяется порядком в исходном массиве.