update

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

Author: mokevnin

modules/30-variables/19-naming-style/ru/EXERCISE.md

@@ -1,3 +1,4 @@
-Создайте две переменные с именами «первое число» и «второе число» на английском языке используя snake_case. Запишите в первую переменную число `20`, во вторую — `-100`. Выведите на экран произведение значений переменных.
-
-- То как вы назовете переменные не принципиально, тесты это не проверяют.
+1. Создайте две переменные с именами «первое число» и «второе число» на английском языке используя snake_case. То как вы назовете переменные не принципиально, тесты это не проверяют.
+1. Запишите в первую переменную число `20`, во вторую — `-100`.
+1. Вычислите произведение значений этих переменных.
+1. Выведите получившееся число на экран.

modules/30-variables/20-magic-numbers/ru/README.md

@@ -12,11 +12,9 @@ print(rubles_count)
 
 ## 🤨 В чём проблема?
 
-В выражениях использованы непонятные числа: __1.25__ и __60__. Что это за значения? Курс валют? Откуда они взялись? Через месяц или год вы, скорее всего, не вспомните, что именно означают эти числа. А если код откроет другой разработчик, он просто не поймёт, откуда всё берётся.
+В выражениях использованы непонятные числа: __1.25__ и __60__. Что это за значения? Курс валют? Откуда они взялись? Через месяц или год вы, скорее всего, не вспомните, что именно означают эти числа. А если код откроет другой разработчик, он просто не поймёт, откуда всё берётся. Такие числа называются магическими
 
-## 🔍 Такие значения называют «магическими числами»
-
-Магические числа (magic numbers) — это числовые значения, смысл которых не ясен из кода. Чтобы понять их назначение, приходится вникать в контекст или читать дополнительную документацию. Магические числа затрудняют чтение, понимание и поддержку кода.
+Магические числа (magic numbers) — это числовые значения, смысл которых не ясен из кода. Они, обычно, используются в математических выражениях напрямую, без переменных с понятными названиями. Чтобы понять их назначение, приходится вникать в контекст или читать дополнительную документацию. Магические числа затрудняют чтение, понимание и поддержку кода.
 
 ## ✅ Как избежать магии
 
@@ -27,19 +25,13 @@ dollars_per_euro = 1.25
 rubles_per_dollar = 60
 
 euros_count = 1000
-dollars_count = euros_count * dollars_per_euro      # 1250.0
-rubles_count = dollars_count * rubles_per_dollar    # 75000.0
+dollars_count = euros_count * dollars_per_euro   # 1250.0
+rubles_count = dollars_count * rubles_per_dollar # 75000.0
 
 print(rubles_count)
 ```
 
-## 📌 Что изменилось?
-
-- Значения вынесены в отдельные переменные с осмысленными именами.
-- Используется snake_case — стандарт стиля в Python.
-- Отделили данные от логики: сначала определили курсы, потом сделали вычисления.
-- Добавили пустую строку между «исходными данными» и вычислениями — это повышает читаемость.
-- Программа стала немного длиннее, но понятнее. И это — норма.
+Сами числа никуда не делись, но теперь они записаны в переменные, названия которых однозначно говорят, что это.
 
 💬 Вывод
 

modules/30-variables/23-constants/ru/README.md

@@ -4,7 +4,7 @@
 - курс доллара на определённую дату,
 - фиксированная комиссия сервиса.
 
-Такие значения называются константами и обычно записываются немного по другому.
+Такие значения называются константами и их принято отличать от обычных переменных (чтобы не возникло желания их менять).
 
 ## 🔢 Пример: число π
 
@@ -18,8 +18,7 @@ print(PI)  # => 3.14
 
 ## 🧱 Чем отличается константа от переменной?
 
-С технической точки зрения — ничем.
-Константа создаётся так же, как обычная переменная. Python не запрещает менять её значение:
+С технической точки зрения — ничем. Константа создаётся так же, как обычная переменная. Python не запрещает менять её значение:
 
 ```python
 PI = 3.14
@@ -28,6 +27,8 @@ PI = 3.14159  # ❌ Технически возможно, но так дела
 
 Но по соглашению, если переменная названа заглавными буквами, значит — это константа, и менять её нельзя.
 
+В этом смысле Python отличается от большинства других языков, где константа это отдельная конструкция языка, которую нельзя менять как переменные.
+
 ## ✍️ Как оформляются константы
 
 - Все буквы заглавные

modules/31-advanced-strings/25-interpolation/ru/EXERCISE.md

@@ -1,4 +1,4 @@
-Выведите на экран строку `Do you want to eat, <name>?`. Где вместо `<name>` должна использоваться переменная `stark`. Вывод должен получиться таким:
+Выведите на экран строку `Do you want to eat, <name>?`. Где вместо `<name>` должна использоваться уже определенная переменная `stark`. Вывод должен получиться таким:
 
 ```text
 Do you want to eat, Arya?

modules/31-advanced-strings/25-interpolation/ru/README.md

@@ -1,4 +1,4 @@
-Конкатенация работает просто и понятно: строки складываются с помощью +.
+Вспомним как работает конкатенация. Для этого мы соединяем нужные строки (или переменные со строками внутри) с помощью знака `+`.
 
 ```python
 first_name = 'Joffrey'
@@ -8,11 +8,9 @@ print(greeting + ", " + first_name + "!")
 # => Hello, Joffrey!
 ```
 
-Но при этом в сложных выражениях становится трудно сразу увидеть, какой текст получится на выходе. Особенно если в строке используются пробелы, запятые или кавычки — они начинают мешать восприятию.
+Но при этом в сложных выражениях становится трудно сразу увидеть, какой текст получится на выходе. Особенно если в строке используются пробелы, запятые или кавычки — они начинают мешать восприятию. Даже текущий пример требует небольшого напряжения, чтобы понять, какой получится строка.
 
-## 💡 Альтернатива — интерполяция
-
-Интерполяция — это способ встраивать значения переменных прямо внутрь строки. В Python для этого используются f-строки (или format-строки). Вот так:
+По этой причине, во многих языках существует операция, которая называется интерполяция. Интерполяция — это способ встраивать значения переменных прямо внутрь строки. В Python для этого используются f-строки (или format-строки). Вот так:
 
 ```python
 first_name = 'Joffrey'
@@ -24,6 +22,15 @@ print(f'{greeting}, {first_name}!')
 
 Буква f перед кавычками указывает, что внутри строки можно использовать переменные. Их имена записываются в фигурных скобках, и Python автоматически подставляет нужные значения.
 
+Сравните эти два примера рядом:
+
+```python
+print(greeting + ", " + first_name + "!")
+print(f'{greeting}, {first_name}!')
+```
+
+Второй вариант не только понятнее, но и менее "шумный".
+
 ## 🔍 Пример
 
 ```python