From ed053d222e965c8af5896922574b208f1025c63f Mon Sep 17 00:00:00 2001
From: Alexsey Shestakov <shestakovap@skbkontur.ru>
Date: Mon, 23 Apr 2018 12:58:38 +0500
Subject: [PATCH] Improve Russian description of arraySort and arrayReserveSort

---
 docs/ru/functions/array_functions.md        |  8 -------
 docs/ru/functions/higher_order_functions.md | 25 +++++++++++++++++++++
 2 files changed, 25 insertions(+), 8 deletions(-)

diff --git a/docs/ru/functions/array_functions.md b/docs/ru/functions/array_functions.md
index a115ab2a012..79818574fd7 100644
--- a/docs/ru/functions/array_functions.md
+++ b/docs/ru/functions/array_functions.md
@@ -301,14 +301,6 @@ SELECT arraySlice([1, 2, 3, 4, 5], 2, 3) AS res
 
 Если необходимо получить список уникальных элементов массива, можно воспользоваться arrayReduce('groupUniqArray', arr).
 
-## arraySort(arr)
-
-Возвращает отсортированный в восходящем порядке массив `arr`
-
-## arrayReverseSort(arr)
-
-Возвращает отсортированный в нисходящем порядке массив `arr`
-
 ## arrayJoin(arr)
 Особенная функция. Смотрите раздел ["Функция arrayJoin"](array_join.md#functions_arrayjoin).
 
diff --git a/docs/ru/functions/higher_order_functions.md b/docs/ru/functions/higher_order_functions.md
index 6c028a95f6a..857dd4e0e03 100644
--- a/docs/ru/functions/higher_order_functions.md
+++ b/docs/ru/functions/higher_order_functions.md
@@ -78,3 +78,28 @@ SELECT arrayCumSum([1, 1, 1, 1]) AS res
 │ [1, 2, 3, 4] │
 └──────────────┘
 ```
+
+
+### arraySort(\[func,\] arr1, ...)
+
+Возвращает отсортированный в восходящем порядке массив `arr1`. Если задана функция `func`, то порядок сортировки определяется результатом применения функции `func` на элементы массива (массивов).  
+
+Для улучшения эффективности сортировки применяется [Преобразование Шварца](https://ru.wikipedia.org/wiki/%D0%9F%D1%80%D0%B5%D0%BE%D0%B1%D1%80%D0%B0%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_%D0%A8%D0%B2%D0%B0%D1%80%D1%86%D0%B0).
+
+Пример:
+
+```sql
+SELECT arraySort((x, y) -> y, ['hello', 'world'], [2, 1]);
+```
+
+```text
+┌─res────────────────┐
+│ ['world', 'hello'] │
+└────────────────────┘
+```
+
+### arrayReverseSort(\[func,\] arr1, ...)
+
+Возвращает отсортированный в нисходящем порядке массив `arr1`. Если задана функция `func`, то порядок сортировки определяется результатом применения функции `func` на элементы массива (массивов).  
+
+