Merge pull request #21391 from ka1bi4/romanzhukov-DOCSUP-7100-avg

DOCSUP-7100: Edit and translate to Russian (AVG function)

docs/en/sql-reference/aggregate-functions/reference/avg.md

@@ -14,26 +14,19 @@ avg(x)
 
 **Arguments**
 
--   `x` — Values.
-
-`x` must be
-[Integer](../../../sql-reference/data-types/int-uint.md),
-[floating-point](../../../sql-reference/data-types/float.md), or 
-[Decimal](../../../sql-reference/data-types/decimal.md).
+-   `x` — input values, must be [Integer](../../../sql-reference/data-types/int-uint.md), [Float](../../../sql-reference/data-types/float.md), or [Decimal](../../../sql-reference/data-types/decimal.md).
 
 **Returned value**
 
-- `NaN` if the supplied parameter is empty.
-- Mean otherwise.
-
-**Return type** is always [Float64](../../../sql-reference/data-types/float.md).
+-   The arithmetic mean, always as [Float64](../../../sql-reference/data-types/float.md).
+-   `NaN` if the input parameter `x` is empty.
 
 **Example**
 
 Query:
 
 ``` sql
-SELECT avg(x) FROM values('x Int8', 0, 1, 2, 3, 4, 5)
+SELECT avg(x) FROM values('x Int8', 0, 1, 2, 3, 4, 5);
 ```
 
 Result:
@@ -46,11 +39,20 @@ Result:
 
 **Example**
 
+Create a temp table:
+
 Query:
 
 ``` sql
 CREATE table test (t UInt8) ENGINE = Memory;
-SELECT avg(t) FROM test
+```
+
+Get the arithmetic mean: 
+
+Query:
+
+```
+SELECT avg(t) FROM test;
 ```
 
 Result:
@@ -60,3 +62,5 @@ Result:
 │    nan │
 └────────┘
 ```
+
+[Original article](https://clickhouse.tech/docs/en/sql-reference/aggregate-functions/reference/avg/) <!--hide-->

docs/ru/sql-reference/aggregate-functions/reference/argmax.md

@@ -27,13 +27,13 @@ argMax(tuple(arg, val))
 
 **Возвращаемое значение**
 
--   Значение `arg`, соответствующее максимальному значению `val`.
+-   значение `arg`, соответствующее максимальному значению `val`.
 
 Тип: соответствует типу `arg`. 
 
 Если передан кортеж:
 
--   Кортеж `(arg, val)` c максимальным значением `val` и соответствующим ему `arg`.
+-   кортеж `(arg, val)` c максимальным значением `val` и соответствующим ему `arg`.
 
 Тип: [Tuple](../../../sql-reference/data-types/tuple.md).
 
@@ -52,15 +52,15 @@ argMax(tuple(arg, val))
 Запрос:
 
 ``` sql
-SELECT argMax(user, salary), argMax(tuple(user, salary)) FROM salary;
+SELECT argMax(user, salary), argMax(tuple(user, salary), salary), argMax(tuple(user, salary)) FROM salary;
 ```
 
 Результат:
 
 ``` text
-┌─argMax(user, salary)─┬─argMax(tuple(user, salary))─┐
-│ director             │ ('director',5000)           │
-└──────────────────────┴─────────────────────────────┘
+┌─argMax(user, salary)─┬─argMax(tuple(user, salary), salary)─┬─argMax(tuple(user, salary))─┐
+│ director             │ ('director',5000)                   │ ('director',5000)           │
+└──────────────────────┴─────────────────────────────────────┴─────────────────────────────┘
 ```
 
 [Оригинальная статья](https://clickhouse.tech/docs/ru/sql-reference/aggregate-functions/reference/argmax/) <!--hide-->

docs/ru/sql-reference/aggregate-functions/reference/avg.md

@@ -4,8 +4,61 @@ toc_priority: 5
 
 # avg {#agg_function-avg}
 
-Вычисляет среднее.
-Работает только для чисел.
-Результат всегда Float64.
+Вычисляет среднее арифметическое.
 
-[Оригинальная статья](https://clickhouse.tech/docs/en/sql-reference/aggregate-functions/reference/avg/) <!--hide-->
+**Синтаксис**
+
+``` sql
+avg(x)
+```
+
+**Аргументы**
+
+-   `x` — входное значение типа [Integer](../../../sql-reference/data-types/int-uint.md), [Float](../../../sql-reference/data-types/float.md) или [Decimal](../../../sql-reference/data-types/decimal.md).
+
+**Возвращаемое значение**
+
+-   среднее арифметическое, всегда типа [Float64](../../../sql-reference/data-types/float.md).
+-   `NaN`, если входное значение `x` — пустое.
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT avg(x) FROM values('x Int8', 0, 1, 2, 3, 4, 5);
+```
+
+Результат:
+
+``` text
+┌─avg(x)─┐
+│    2.5 │
+└────────┘
+```
+
+**Пример**
+
+Создайте временную таблицу:
+
+Запрос:
+
+``` sql
+CREATE table test (t UInt8) ENGINE = Memory;
+```
+
+Выполните запрос:
+
+``` sql
+SELECT avg(t) FROM test;
+```
+
+Результат:
+
+``` text
+┌─avg(x)─┐
+│    nan │
+└────────┘
+```
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/sql-reference/aggregate-functions/reference/avg/) <!--hide-->