update content

Signed-off-by: Kirill Mokevnin <[email protected]>

Author: mokevnin

modules/30-variables/13-variables-naming/ru/README.md

@@ -1,23 +1,40 @@
-
-Представьте, что мы задали следующую программу:
+Представьте, что у нас есть такая программа:
 
 ```python
 x = 'Father!'
 print(x)
 ```
 
-С подобной программой мы уже работали, но сейчас в ней изменилось имя переменной на `x`.
+С технической точки зрения — всё работает. Мы уже видели похожие примеры, но здесь используется переменная с названием `x`. Плохие имена мешают читать и понимать код. Вот несколько примеров неудачных переменных:
+
+```python
+a = "John"
+n = 42
+ddr = "New York"
+```
+
+Что это за переменные? Что в них хранится? Чтобы это понять, нужно читать весь остальной код и догадываться по контексту.
 
-Компьютеру без разницы, как мы именуем ту или иную переменную. Названия важны только людям.  Обычно программисты гораздо чаще читают чужой код, чем пишут свой. Чтобы коллеги смогли с легкостью прочитать и проанализировать ваш код, нужно понятно называть переменные.
+Компьютеру всё равно, как называется переменная. Для него `x`, `abc`, `message` или `elephant_in_the_room` — просто метки для хранения данных. Но людям — не всё равно. Программисты читают код гораздо чаще, чем пишут. Поэтому имена переменных — это не просто мелочь, а важная часть общения через код.
+
+## ✅ Хорошие примеры
+
+```python
+user_name = "Arya Stark"
+unpaid_orders_count = 3
+max_attempts = 5
+email_verified = False
+```
 
-Важно придумать понятное название, которое отражает смысл переменной. При этом важно давать такие имена, которые будут понимать без контекста, без изучения окружающего кода.
+Хорошее имя переменной помогает понять, что делает программа, не вчитываясь в каждую строчку.
+Особенно важно давать такие имена, смысл которых понятен без контекста — без необходимости читать весь код вокруг.
 
-Существует общепринятое правило: не используйте транслит для имен — только английский язык. Если вы испытываете сложности с английским, то пользуйтесь переводчиком. Со временем, копаясь в чужом коде, вы научитесь правильно именовать переменные.
+Вот несколько советов:
 
-Среди разработчиков есть шутка: «Названия переменных — это одна из самых сложных вещей в программировании». Придумывать названия и правда сложно. Например, сложно назвать переменную, в которой хранится _количество неоплаченных заказов от клиентов с задолженностью в предыдущем квартале._
+- Используйте английский язык. Это международный стандарт. Не стоит писать `kolvo_zakazov` — лучше `orders_count`. Если с английским пока сложно — используйте переводчик, это нормально. Со временем станет проще.
+- Старайтесь, чтобы имя отражало смысл переменной. Пусть оно будет чуть длиннее, но понятное.
+- Не бойтесь тратить время на подбор хорошего названия. Это инвестиция в читаемость и поддержку кода.
 
-Чтобы проверить себя, попробуйте сделать такое задание:
+Среди программистов даже есть шутка: «Одни из самых трудных задач в программировании — это кэширование и придумывание имён переменным.» Иногда придумать имя — действительно сложно. Вот пример: как бы вы назвали переменную, в которой хранится количество неоплаченных заказов от клиентов с задолженностью за предыдущий квартал?
 
-> Придумайте название для переменной, в которой будет храниться *«количество братьев и сестер короля»*.
->
-> Запишите его в блокноте или отправьте себе на почту. Не указывайте там ничего, кроме названия переменной. А через несколько уроков мы вернемся к этой теме.
+А теперь — небольшое упражнение: Придумайте название для переменной, в которой будет храниться «количество братьев и сестер короля». Запишите его в блокноте или отправьте себе на почту. Только название, без объяснений. Мы вернемся к этому заданию через несколько уроков.

modules/30-variables/14-errors/ru/EXERCISE.md

@@ -1,5 +1,4 @@
-
-Найдите в программе необъявленную переменную и объявите ее, присвоив ей значение 'Dragon'.
+Найдите в программе необъявленную переменную и объявите ее, присвоив ей значение _Dragon_.
 
 После выполнения программы результат на экране должен выглядеть так:
 

modules/30-variables/15-variables-expressions/ru/EXERCISE.md

@@ -1,4 +1,3 @@
-
 Напишите программу, которая берет исходное количество евро, записанное в переменную `euros_count`, переводит евро в доллары и выводит на экран. Затем полученное значение переводит в юани и выводит на новой строчке.
 
 Пример вывода для 100 евро:

modules/30-variables/15-variables-expressions/ru/README.md

@@ -1,20 +1,38 @@
+Мы уже знаем, что переменные позволяют хранить и переиспользовать данные. Но они также помогают упрощать вычисления — как математические, так и строковые. Рассмотрим это на примерах.
 
-Мы уже разобрались, как работать с переменными, чтобы хранить и переиспользовать информацию. Но еще они помогают упрощать сложные вычисления. Например, конвертация валюты или составление нового слова. Рассмотрим, как это делать на практике.
+## 💱 Конвертация валют через промежуточную валюту
 
-Представим, что нам нужно перевести евро в юани через доллары. Подобные конвертации через промежуточную валюту часто делают банки при покупках за рубежом.
+Представим, что нужно перевести евро в юани, но напрямую такой курс нам недоступен. Тогда сделаем это в два шага: **евро → доллары → юани**. Так часто работают банки при оплате покупок за рубежом.
 
-Для начала переведем 50 евро в доллары. Допустим, что один евро — 1.25 долларов:
+## Шаг 1. Евро → Доллары
+
+Допустим, курс: 1 евро = 1.25 доллара. Хотим перевести 50 евро:
 
 ```python
 dollars_count = 50 * 1.25
 print(dollars_count)  # => 62.5
 ```
 
-Здесь в переменную `dollars_count = 50 * 1.25` справа от знака «равно» мы записываем **выражение**. Интерпретатор вычислит результат (`62.5`) и запишет его в переменную.  Интерпретатору не важно, в каком виде записаны данные: `62.5` или `50 * 1.25`. Для него оба варианта — выражения, которые надо вычислить. Он проводит вычисления и приходит к одному и тому же значению — `62.5`.
+В этой строке 50 \* 1.25 — это выражение, а dollars_count — переменная, в которую записывается результат. Python сначала вычисляет выражение, а уже потом сохраняет результат в переменную.
+
+Интерпретатору всё равно, как записано выражение:
+
+```python
+dollars_count = 62.5
+```
+
+или
+
+```python
+dollars_count = 50 * 1.25
+```
+
+Результат будет один и тот же.
 
-Любая строка — выражение. Конкатенация строк (склеивание значений переменных) — это тоже выражение. Когда интерпретатор видит выражение, он обрабатывает его и генерирует результат — **значение выражения**.
+## 📘 Что такое выражение?
 
-Вот несколько примеров выражения. В комментариях справа от каждого выражения записаны итоговые значения:
+Выражение — это комбинация данных и операций, из которой можно получить значение.
+Примеры:
 
 ```python
 62.5             # 62.5
@@ -26,42 +44,37 @@ int('100')       # 100
 'Good' + 'will'  # Goodwill
 ```
 
-В тех местах, где ожидается выражение, можно поставить любое вычисление. Оно может быть не только математическим, но и строковым — как конкатенация. Программа все равно останется работоспособной.
+Обратите внимание: строки — это тоже выражения. А операция + со строками называется конкатенацией — она "склеивает" строки в одну.
 
-Программы состоят из множества комбинаций выражений. Основываясь на сказанном выше, подумайте, сработает ли такой код:
+Если вы понимаете, что перед вами выражение, вы знаете: Python сначала его вычислит, а уже потом продолжит выполнение программы. Это особенно важно, когда выражения становятся сложными и включают переменные, функции и даже другие выражения внутри.
+
+## ✨ Пример со строками
+
+Подумайте, сработает ли такой код:
 
 ```python
 who = "dragon's " + 'mother'
 print(who)
 ```
 
-Такой код выведет на экран строку `dragon's mother`. Если хотите проверить самостоятельно, запустите код на [repl.it](https://replit.com/languages/python3) и поэкспериментируйте.
-
-С помощью переменных можно записывать еще более сложные вычисления. Вернемся к нашей валютной программе. Запишем стоимость доллара в юанях, как отдельную переменную. Вычислим цену 50 евро в долларах, умножив их на `1.25`. Допустим, что 1 доллар — 6.91 юаней:
-
-```python
-yuans_per_dollar = 6.91
-dollars_count = 50 * 1.25  # 62.5
-yuans_count = dollars_count * yuans_per_dollar  # 431.875
+Ответ: да, всё отлично сработает. На экран выведется строка: _dragon's mother_
 
-print(yuans_count)
-```
+## Шаг 2. Доллары → Юани
 
-Теперь добавим к выводу текст с помощью конкатенации:
+Теперь переведем доллары в юани. Допустим, курс: 1 доллар = 6.91 юаней.
 
 ```python
 yuans_per_dollar = 6.91
-dollars_count = 50 * 1.25  # 62.5
+dollars_count = 50 * 1.25              # 62.5
 yuans_count = dollars_count * yuans_per_dollar  # 431.875
 
-# Функция str() превращает число в строку.
-# О таких превращениях будет отдельный урок.
-print('The price is ' + str(yuans_count) + ' yuans')
-# => The price is 431.875 yuans
+print(yuans_count)
 ```
 
-Любая переменная может быть частью любого выражения. В момент вычисления вместо имени переменной подставляется ее значение.
+Переменные можно использовать внутри других выражений. Когда Python видит переменную, он подставляет её значение, а затем выполняет вычисления.
 
-Интерпретатор вычисляет значение `dollars_count` до того, как эта переменная начнет использоваться в других выражениях. Когда подходит момент использования переменной, Python уже знает значение, потому что вычислил его.
+## 📌 Что нужно запомнить
 
-С помощью переменных можно проводить сложные вычисления, а также делать подробный вывод с получившимся значением. Но еще можно получать новые выражения посредством склеивания двух и более значений переменных. За это отвечает конкатенация.
+- Выражения могут быть числовыми, строковыми и даже смешанными (если правильно использовать преобразования).
+- Переменные можно использовать внутри других выражений. Python подставит их значения и выполнит нужные вычисления.
+- Все программы состоят из комбинаций выражений — именно они дают результат.

modules/30-variables/18-variable-concatenation/ru/EXERCISE.md

@@ -1,4 +1,3 @@
-
 Сайты постоянно посылают письма своим пользователям. Типичная задача — сделать автоматическую отправку персонального письма, где в заголовке будет имя пользователя. Если где-то в базе сайта хранится имя человека в виде строки, то задача генерации заголовка сводится к конкатенации: например, нужно склеить строку `Здравствуйте` со строкой, где записано имя.
 
 Напишите программу, которая будет генерировать заголовок и тело письма, используя уже готовые переменные, и выводить получившиеся строки на экран.