update

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

Author: mokevnin

modules/38-objects/100-objects/ru/README.md

@@ -16,6 +16,9 @@ print(text.upper())  # => HEXLET
 Встроенных методов у строк довольно много. Ниже некоторые из них:
 
 ```python
+# Перевод первой буквы в верхний регистр
+'hexlet'.capitalize()  # => Hexlet
+
 # Перевод всех букв в нижний регистр
 print('HeXleT'.lower())  # => hexlet
 

modules/40-define-functions/100-define-function/ru/EXERCISE.md

@@ -1,4 +1,3 @@
-
 Реализуйте функцию с именем `print_motto()`, которая выведет на экран фразу *Winter is coming*.
 
 ```python

modules/40-define-functions/100-define-function/ru/README.md

@@ -1,55 +1,88 @@
-С помощью определения собственных функций писать и поддерживать программы проще. Они позволяют объединять составные операции в одну. Поэтому в этом уроке поговорим, как создавать собственные функции.
+До этого момента мы использовали только уже готовые функции — `print()`, `len()`, `max()` и другие. Но в Python можно создавать свои собственные функции. Это основа программирования: выделение повторяющейся логики в именованные блоки кода.
 
-Допустим, мы хотим отправить письма на сайте — это достаточно сложный процесс, который включает взаимодействие с внешними системами. Но если определить функцию, вся сложность скроется за одной простой функцией:
+## Зачем определять функции
+
+Допустим, у нас есть несколько похожих участков кода:
+
+```python
+print('Hello, Hexlet!')
+print('Hello, world!')
+print('Hello, Python!')
+```
+
+Чтобы не повторять один и тот же шаблон, мы можем оформить его в виде своей функции, которая принимает на вход один параметр и печатает нужную строчку на экран:
 
 ```python
-# Гипотетический пример
-# Место откуда берется функция
-from emails import send
+def say_hello(name):
+    print(f'Hello, {name}!')
+```
 
-email = 'support@hexlet.io'
-title = 'Помогите'
-body = 'Я написал историю успеха, как я могу получить скидку?'
+Теперь мы можем вызывать её с разными аргументами:
 
-# Один маленький вызов — много логики внутри
-send(email, title, body)
+```python
+say_hello('Hexlet')   # => Hello, Hexlet!
+say_hello('world')    # => Hello, world!
+say_hello('Python')   # => Hello, Python!
 ```
 
-Внутри себя этот вызов выполняет много логики: соединяется с почтовым сервером, формирует правильный запрос на основе заголовка и тела сообщения, а затем все отправляет, не забыв закрыть соединение.
+В нашем примере функция ничего не возвращает, она действует как `print()` выводя на экран сообщение.
 
-Создадим нашу первую функцию. Ее задача — вывести на экран приветствие:
+## Синтаксис определения
 
-```text
-Hello, Hexlet!
+```python
+def имя_функции(параметры):
+    тело
 ```
 
+- `def` — ключевое слово, с которого начинается определение.
+- `имя_функции` — любое допустимое имя, как у переменной.
+- В скобках — список параметров, через запятую.
+- После двоеточия — тело функции. Оно пишется с отступом в 4 пробела
+- Чтобы функция что-то делала, в её теле пишется обычный Python-код.
+
+В Python отступы имеют синтаксическое значение. Они показывают, какой код относится к телу функции. Посмотрите на пример:
+
 ```python
-# Определение функции
-# Определение не вызывает и не выполняет функцию
-# Мы лишь говорим, что теперь такая функция существует
-def show_greeting():
-    # Внутри тела отступ четыре пробела
-    text = 'Hello, Hexlet!'
-    print(text)
-
-# Вызов функции
-show_greeting()  # => 'Hello, Hexlet!'
+def say_hi():
+    print('Hi!')
+
+print('Программа продолжается…')
 ```
 
-В отличие от обычных данных, функции выполняют действия. Поэтому их имена нужно указывать через глаголы: «построить что-то», «нарисовать что-то», «открыть что-то».
+Здесь функция `say_hi()` определена, но **`print('Программа продолжается…')`** не относится к функции — у него нет отступа. Он будет выполнен сразу при запуске программы, независимо от вызова `say_hi()`.
+
+Чтобы `say_hi()` сработала, её нужно явно вызвать:
 
-Описание, которое находится ниже имени функции с отступом, называется **телом функции**. Внутри тела можно описывать любой код. Это как небольшая самостоятельная программа — набор произвольных инструкций.
+```python
+def say_hi():
+    print('Hi!')
+
+say_hi()  # => Hi!
+print('Программа продолжается…')
+```
 
-Тело выполняется в тот момент, когда запускается функция. При этом каждый вызов функции запускает тело независимо от других вызовов.
+## Пример: функция для печати среднего арифметического
 
-Тело функции может быть пустым, тогда внутри него используется ключевое слово `pass`:
+Сейчас мы реализуем простую функцию, которая **вычисляет и печатает среднее арифметическое** двух чисел. Среднее арифметическое — это сумма чисел, делённая на их количество. Например, среднее от 6 и 4 считается так: `(6 + 4) / 2 = 5`.
 
 ```python
-# Минимальное определение функции
-def noop():
-    pass
+def print_average(a, b):
+    total = a + b
+    average = total / 2
+    print(average)
 
-noop()
+print_average(6, 4)  # => 5.0
 ```
 
-У понятия «создать функцию» много синонимов: «реализовать», «определить» и даже «заимплементить». Они часто встречаются на практике. Создавая свою функцию, вы облегчите сложные операции и сделаете разработку проще.
+Здесь:
+
+- `a` и `b` — входные параметры функции.
+- `total` — сумма этих чисел.
+- `average` — делим сумму на 2, чтобы найти среднее.
+- `print()` выводит результат.
+
+При вызове `print_average(6, 4)` на экран выведется `5.0`.
+
+## Переиспользование и читаемость
+
+Функции помогают не только избегать дублирования, но и делают программы более понятными. Название функции само по себе говорит, что она делает. Это особенно важно в больших проектах, где код читают другие программисты (или вы сами через месяц).

modules/40-define-functions/200-return/index.py

@@ -1,7 +1,5 @@
-# BEGIN
-def say_hurray_three_times():
-    word = "hurray!"
-    return f"{word} {word} {word}"
-
-
-# END
+def truncate(text, length):
+    # BEGIN
+    result = f"{text[0:length]}..."
+    return result
+    # END

modules/40-define-functions/200-return/ru/EXERCISE.md

@@ -1,7 +1,27 @@
+Допишите функцию `truncate()`, которая обрезает переданную строку до указанного количества символов, добавляет в конце троеточие и возвращает получившуюся строку. Подобная логика часто используется на сайтах, чтобы отобразить длинный текст в сокращенном виде.
 
-Реализуйте функцию `say_hurray_three_times()`, которая возвращает строку 'hurray! hurray! hurray!'.
+Функция принимает два параметра:
+
+1. Строка, которую нужно обрезать
+2. Число символов, которые нужно оставить
+
+Пример того, как должна работать написанная вами функция:
+
+```python
+# Передаём текст напрямую
+# Обрезаем текст, оставляя 2 символа
+truncate('hexlet', 2)  # 'he...'
+
+# Через переменную
+text = 'it works!'
+# Обрезаем текст, оставляя 4 символа
+truncate(text, 4)  # 'it w...'
+```
+
+Выполнить задание можно различными способами, подскажем лишь один из них. Для решения этим способом вам понадобится взять подстроку из строки, переданной первым параметром в функцию. Используйте для этого срезы строк. Подумайте, исходя из задания, с какого индекса и по какой вам надо извлечь подстроку?
 
 ```python
-hurray = say_hurray_three_times()
-print(hurray) # => hurray! hurray! hurray!
+word = 'welcome!'
+index = 3
+word[:index] # wel
 ```