update

Signed-off-by: Kirill Mokevnin <mokevnin@gmail.com>

Author: mokevnin

modules/35-calling-functions/180-variadic-parameters/ru/EXERCISE.md

@@ -1,2 +1 @@
-
 Посчитайте программно (а не в голове) минимальное число среди 3, 10, 22, -3, 0 — и выведите его на экран. Воспользуйтесь функцией `min()`, которая работает аналогично `max()`.

modules/35-calling-functions/180-variadic-parameters/ru/README.md

@@ -1,22 +1,32 @@
+У некоторых функций есть особенность — они принимают переменное число аргументов. Это не связано со значениями по умолчанию, как в случае с `round()`. Речь идёт о том, что количество передаваемых данных не ограничено фиксированным числом.
 
-В этом уроке мы разберем функцию `max()`, а также посмотрим, как она работает в Python.
-
-У некоторых функций есть особенность — они принимают переменное число параметров. И мы говорим не о значениях по умолчанию. Посмотрите на этот пример:
+Рассмотрим функцию `max()`. Она находит наибольшее значение из переданных данных.  
 
 ```python
-max(1, 10, 3)  # 10
+print(max(1, 10, 3))       # => 10
+print(max(1, -3, 2, 3, 2)) # => 3
 ```
 
-В примере выше функция `max()` находит максимальное значение среди переданных параметров. Чтобы узнать, сколько параметров можно передавать на вход, нужно изучить [документацию](https://docs.python.org/3/library/functions.html?highlight=pow#max) этой функции. Там мы увидим такую конструкцию:
+В документации можно встретить несколько вариантов описания `max()`. Чтобы упростить понимание, сосредоточимся на одном, который нам сейчас нужен:  
 
 ```python
-max(arg1, arg2, *args[, key])
+max(arg1, arg2, /, *args, key=None)
 ```
 
-Это значит, что `max()` принимает на вход два параметра и больше:
+Это значит:  
+- функция требует как минимум два значения (`arg1` и `arg2`);  
+- дальше можно передавать ещё сколько угодно значений (`*args`);  
+- функция вернёт наибольшее из переданных.  
+
+Если среди аргументов есть несколько одинаковых максимальных значений, возвращается первый из них.  
 
 ```python
-max(1, -3, 2, 3, 2)  # 3
+print(max(5, 5, 2))  # => 5
 ```
 
-Если функция найдет несколько параметров с максимальным значением, значит, она вернет самый первый из них.
+Аналогично работает функция `min()`, только она ищет наименьшее значение:  
+
+```python
+print(min(1, 10, 3))       # => 1
+print(min(1, -3, 2, 3, 2)) # => -3
+```

modules/35-calling-functions/270-deterministic/ru/EXERCISE.md

@@ -1,4 +1,3 @@
-
 Функция `random()` возвращает случайное число от 0 до 1 с большим количеством знаков после запятой. Реализуйте код, который выводит на экран случайное целое число в диапазоне от 0 до 10. Для этой задачи вам понадобится функция `random()` и функция [round()](https://docs.python.org/3/library/functions.html#round), которая округляет переданное ей значение
 
 ```python
@@ -8,4 +7,5 @@ round(2.320000789855705) # 2
 Попробуйте решить это задание в одну строчку
 
 ## Алгоритм
+
 Так как функция `random()` возвращает числа в диапазоне от 0 до 1, то чтобы получить числа от 0 до 10, нам нужно выполнить умножение на 10. Затем получившиеся число округляется и так мы получаем то, что нужно.

modules/35-calling-functions/270-deterministic/ru/README.md

@@ -1,7 +1,6 @@
+У функций в любом языке программирования есть фундаментальные свойства. Эти свойства помогают понимать, как функция будет вести себя в разных ситуациях, как её тестировать и где применять. Одно из таких свойств — **детерминированность**.
 
-У функций внутри каждого языка программирования есть фундаментальные свойства. Эти свойства помогают прогнозировать поведение функций, способы их тестирования и место использования. К таким свойствам относится детерминированность.
-
-Детерминированная функция возвращает один и тот же результат для одинаковых входных параметров. Например, детерминированной можно назвать функцию, которая считает количество символов:
+**Детерминированная функция** всегда возвращает один и тот же результат при одинаковых входных данных. Например, детерминированной можно назвать функцию, которая считает количество символов:
 
 ```python
 len('hexlet')  # 6
@@ -11,9 +10,11 @@ len('wow')  # 3
 len('wow')  # 3
 ```
 
-Можно бесконечно вызывать эту функцию и передавать туда значение `'hexlet'` — она всегда вернет `6`.
+Функцию `len()` можно вызывать бесконечно с одним и тем же аргументом, и она всегда вернёт один и тот же результат.
+
+## Недетерминированные функции
 
-Посмотрим и обратный случай — недетерминированные функции. Например, к этой категории относится функция, которая возвращает случайное число: у одного и того же входа мы получим всегда разный результат. Если хотя бы один из миллиона вызовов функция вернет другой результат, она считается недетерминированной. Это работает и в том случае, если параметры не принимаются:
+Есть и обратные примеры — **недетерминированные функции**. Это функции, которые могут возвращать разные результаты при одинаковых входных данных или при их отсутствии (функции без параметров).  Хороший пример — функция, которая возвращает случайное число:
 
 ```python
 # Синтаксис импортов будет изучаться позже на Хекслете
@@ -24,4 +25,14 @@ random()  # 0.09856613113197676
 random()  # 0.8839904367241888
 ```
 
-Детерминированность — это важное свойство функции, так как она влияет на многие аспекты. Например, детерминированные функции удобны в работе — их легко оптимизировать и тестировать. Если возможно, то лучше сделать функцию детерминированной.
+У этой функции нет аргументов, но её результат каждый раз разный. Если хотя бы один вызов среди миллионов даст другой результат, функция считается недетерминированной.
+
+## Почему это важно
+
+Детерминированность влияет на то, как мы работаем с функциями:
+
+- детерминированные функции легко тестировать и предсказывать;
+- их проще оптимизировать и использовать повторно;
+- недетерминированные функции сложнее проверять, потому что результат меняется.
+
+Поэтому там, где это возможно, лучше стремиться к тому, чтобы функция была детерминированной.