update content

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

Author: mokevnin

Diff for: modules/30-variables/10-definition/ru/EXERCISE.md

@@ -1,2 +1 @@
-
 Создайте переменную с именем `motto` и содержимым `What Is Dead May Never Die!`. Распечатайте содержимое переменной.

Diff for: modules/30-variables/10-definition/ru/README.md

@@ -1,31 +1,73 @@
-
-Представьте, что нам нужно напечатать на экран фразу *Father!* два раза. Эту задачу можно решить так:
+Представьте, что нужно напечатать фразу Father! два раза:
 
 ```python
 print('Father!')
 print('Father!')
 ```
 
-В простейшем случае так и стоит поступить. Но если фраза *Father!* будет использоваться чаще двух раз, да еще и в разных частях программы, то придется ее везде повторять — это неудобно. Проблемы с таким подходом начнутся, когда понадобится изменить фразу, а такое происходит довольно часто. Нам придется найти все места с этой фразой и выполнить необходимую замену.
+Такой способ вполне подойдёт, если фраза встречается всего пару раз. Но что, если она будет использоваться часто, в разных частях программы? Тогда придётся копировать одно и то же выражение снова и снова.
+
+А что будет, если фразу нужно изменить — например, заменить _Father!_ на _Mother!_? Придётся искать и исправлять все вхождения вручную. Это неудобно и приводит к ошибкам.
+
+## Что делать вместо копирования
 
-А можно поступить по-другому. Чтобы не копировать выражение, достаточно создать с ней переменную:
+Чтобы не дублировать одну и ту же строку, её можно сохранить в переменной:
 
 ```python
-# greeting - переводится как приветствие
 greeting = 'Father!'
 print(greeting)
 print(greeting)
-# => Father!
-# => Father!
 ```
 
-В строчке `greeting = 'Father!'` мы берем переменную с именем `greeting` и присваиваем ей значение `'Father!'`. Переменная указывает на данные, которые в нее записали. Благодаря этому, данные можно использовать многократно и не дублировать их постоянно.
+Результат:
+
+```python
+Father!
+Father!
+```
+
+Мы создали переменную с именем `greeting` и записали в неё строку _Father!_. Теперь вместо текста можно использовать имя переменной. Программа подставляет значение переменной туда, где она используется.
+
+## Что такое переменная
+
+Переменная — это имя, за которым прячутся данные. Она нужна, чтобы:
+
+- Использовать одни и те же данные несколько раз;
+- удобно обновлять значение в одном месте;
+- сделать код понятнее.
+
+Когда интерпретатор доходит до строки `print(greeting)`, он сначала подставляет содержимое переменной, а потом выполняет вывод.
+
+## Имена переменных
+
+Имена переменных придумывает сам программист. В Python можно использовать:
+
+- Латинские буквы (a–z, A–Z),
+- цифры (но не в начале),
+- нижнее подчёркивание _.
+
+Примеры допустимых имён: `greeting`, `name1`, `hello_world`.
+
+🔠 Важно: Python различает строчные и заглавные буквы. Переменные `greeting`, `Greeting` и `GREETING` — это три разные переменные.
+
+### 💡 Рекомендации по именованию
+
+Python-разработчики придерживаются определённых соглашений по стилю — стандарта PEP8:
+
+- Используйте строчные буквы с подчёркиванием между словами:
+
+    ✅ `user_name`, `error_message`, `greeting_text`
+
+- Имена должны быть понятными — не a или x, а name, message, counter.
+- Не используйте русские слова, даже если они записаны латиницей:
+
+    🚫 `privet`, `mama`, `stroka`
 
-Когда переменная создана, можно ее использовать. Она подставляется в те места, где раньше стояла наша фраза. Когда код выполняется, интерпретатор доходит до строчки `print(greeting)` и подставляет содержимое переменной, а затем выполняет код.
+    ✅ `greeting`, `text`, `title`
 
-Для имени переменной используется любой набор допустимых символов, к которым относятся буквы английского алфавита, цифры и знак `_`. При этом цифру нельзя ставить в начале. Имена переменных регистрозависимы, то есть имя `hello` и имя `HELLO` — это два разных имени для двух разных переменных. Регистр в Python имеет важное значение, никогда не забывайте про него.
+## Несколько переменных в программе
 
-Количество создаваемых переменных неограниченно. Большие программы содержат десятки и сотни тысяч имен переменных. Вот как выглядят две переменные внутри одной программы:
+В одной программе можно создать сколько угодно переменных. Каждая хранит свои данные и не мешает другим:
 
 ```python
 greeting1 = 'Father!'
@@ -37,6 +79,6 @@ print(greeting2)
 print(greeting2)
 ```
 
-https://replit.com/@hexlet/python-basics-variables-definition
+## Где создавать переменные
 
-Чтобы программу было удобно читать, среди программистов принято создавать переменные как можно ближе к тому месту, где они используются. Теперь нужно разобраться, как их изменять.
+Программисты стараются создавать переменные ближе к месту, где они используются. Это делает код более читаемым. Особенно важно это в больших программах, где переменных может быть десятки и сотни тысяч.

Diff for: modules/30-variables/12-change/ru/EXERCISE.md

@@ -1,4 +1,3 @@
-
 В упражнении определена переменная, внутри которой содержится строка. Переопределите значение этой переменной и присвойте ей строку, в которой расположите символы первоначальной строки в обратном порядке.
 
-Обратите внимание: в данном задании вам предстоит писать код между строчками с комментариями `# BEGIN` и `# END` (об этом говорилось ранее, но это первый раз, когда вы встречаетесь с таким форматом).
+Обратите внимание: в данном задании вам предстоит писать код между строчками с комментариями `# BEGIN` и `# END`

Diff for: modules/30-variables/12-change/ru/README.md

@@ -1,19 +1,56 @@
+Само слово «переменная» подсказывает, что её значение может меняться. Это одна из главных причин, почему переменные вообще существуют.
 
-Само слово «переменная» подсказывает, что ее можно менять. И действительно, со временем внутри программы значения переменных могут изменяться.
-
-Например:
+Вот простой пример:
 
 ```python
-# greeting - переводится как приветствие
+# greeting — переводится как приветствие
 greeting = 'Father!'
 print(greeting)  # => Father!
 
 greeting = 'Mother!'
 print(greeting)  # => Mother!
 ```
 
-https://replit.com/@hexlet/python-basics-variables-change
+Здесь мы сначала записали в переменную одну строку (_Father!_), потом — другую (_Mother!_). Имя переменной не изменилось, но значение внутри стало другим.
+
+## Зачем вообще менять значение?
+
+В реальных программах переменные меняются постоянно. Вот несколько причин:
+
+- Программа реагирует на действия пользователя. Например, пока вы вводите какие-то данные, в формы на сайте, они, в этот момент, вполне вероятно, постоянно меняют переменные, которые эти данные содержат
+- Промежуточные результаты. Часто данные проходят через серию преобразований — на каждом этапе переменная обновляется новым значением. Подобный механизм даже есть в калькуляторах, когда промежуточные значения сохраняются с помощью клавиш `m+` или `m-`.
+- Хранение состояния. Если вы пишете игру, то положение персонажа, его здоровье, счёт, текущий уровень — всё это переменные, которые постоянно меняются.
+
+## Переменные создаются по мере использования
+
+В Python переменную не нужно «объявлять заранее» — она появляется в момент, когда вы впервые записываете в неё значение:
+
+```python
+name = 'Arya'  # переменная создаётся здесь
+```
+
+Если потом вы снова напишете name = ..., это перезапишет старое значение. Так работает большинство современных языков программирования.
+
+⚠️ Но важно помнить: переменную нельзя использовать раньше, чем она создана.
+
+```python
+print(name)      # Ошибка! Переменная ещё не создана
+name = 'Arya'
+```
+
+Python не знает, что такое name, потому что вы ещё ничего туда не записали. При запуске программа остановится и покажет сообщение об ошибке.
+
+✅ Правильный порядок:
+
+```python
+name = 'Arya'     # Сначала создаём
+print(name)       # Потом используем
+```
+
+## Почему это важно
+
+Переменные — это гибкий способ хранить данные, которые могут изменяться в процессе выполнения программы. Благодаря этому можно писать программы, которые ведут себя по-разному в зависимости от условий, действий пользователя или результатов вычислений.
 
-Имя осталось тем же, но внутри появились другие данные. Отметим, что переменные в Python не требуют специального объявления. Вместо этого переменная объявляется, когда ее впервые используют в программе.
+Но у гибкости есть и обратная сторона. Иногда сложно сразу понять, что именно записано в переменную в тот или иной момент времени. Разработчику приходится отслеживать, где и как она изменилась — особенно если код длинный.
 
-Переменные — мощная и в то же время рисковая вещь. Нельзя сразу с уверенностью сказать, что внутри нее записано — сначала надо проанализировать код, который находится перед переменной. Именно этим занимаются разработчики во время отладки, когда пытаются разобраться, почему программа работает не так, как задумано.
+Именно это делают во время отладки — когда пытаются разобраться, почему программа работает не так, как задумано. Проверяют значения переменных, отслеживают порядок выполнения кода, ищут, где что-то пошло не так.