update content

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

Author: mokevnin

modules/10-basics/10-hello-world/ru/README.md

@@ -10,8 +10,22 @@ Hello, World!
 print('Hello, World!')
 ```
 
-В следующих уроках мы подробно разберем все элементы этого кода и научимся писать гораздо более сложные и интересные программы
+`print()` — это команда, которая работает по определённому шаблону: в скобках указывается текст для вывода на экран. Мы можем передавать туда любой другой текст.
 
-## Регистр символов
+```python
+print('Хекслет - школа программирования')
+```
+
+Команда остаётся той же, меняется только содержимое скобок. Чтобы программа понимала, что это именно текст, он заключается в кавычки. Можно использовать одинарные `'...'` или двойные `"..."`, главное — чтобы открывающая и закрывающая кавычки совпадали.
+
+```python
+print("Хекслет - школа программирования")
+```
+
+По принятому в Python стандарту оформления кода (PEP 8) рекомендуется использовать одинарные кавычки для строк, если внутри них нет апострофа. Это делает код более единообразным.
+
+## Значение символов
+
+Программирование — это не просто текст на английском. Код состоит из команд, и каждая из них должна быть написана в определённой форме. Для этого используются не только буквы, но и специальные символы: кавычки `'` и `"`, скобки `()`, запятая `,`, восклицательный знак `!`. Они не случайные — каждый символ имеет своё значение. Если пропустить знак или перепутать его, программа не запустится.
 
-В программировании каждый символ имеет значение. Даже небольшое отличие, например одна лишняя буква или другой знак, может привести к тому, что программа не будет работать. Это относится и к такому понятию, как регистр — различию между большими и маленькими буквами. Если в обычном тексте `Привет` и `привет` выглядят одинаково, то для Python (как и других языков) это разные слова. Поэтому `print`, `Print` и `PRINT` — это разные команды, и сработает только первый вариант.
+Даже небольшое отличие, например одна лишняя буква или другой знак, может привести к тому, что программа не будет работать. Это относится и к такому понятию, как регистр — различию между большими и маленькими буквами. Если в обычном тексте `Привет` и `привет` выглядят одинаково, то для Python (как и других языков) это разные слова. Поэтому `print`, `Print` и `PRINT` — это разные команды, и сработает только первый вариант.

modules/10-basics/30-instructions/ru/README.md

@@ -1,20 +1,14 @@
 Когда мы готовим блюдо, то следуем рецепту шаг за шагом. Пропустим этап — и результат будет отличаться от ожидаемого. В программировании работает тот же принцип: чёткий порядок инструкций определяет, как работает программа.
 
-Инструкция (или оператор) — это команда для компьютера. Она говорит: «сделай что-то прямо сейчас».
+Инструкция (или оператор) — это команда для компьютера. Она говорит: «сделай что-то прямо сейчас». Интерпретатор Python (специальная программа, которая понимает и выполняет код) выполняет код сверху вниз, по строкам. Он обрабатывает каждую инструкцию по очереди, как если бы читал рецепт по шагам.
 
-В Python программа состоит из инструкций — отдельных команд, которые выполняются компьютером. Это как пошаговый рецепт: одна строка — один шаг.
-
-Интерпретатор Python (специальная программа, которая понимает и выполняет код) выполняет код сверху вниз, по строкам. Он обрабатывает каждую инструкцию по очереди, как если бы читал рецепт по шагам.
-
-Вот пример кода с двумя инструкциями:
+Вот пример кода с двумя инструкциями. Эти строки говорят компьютеру: «Выведи фразу на экран».
 
 ```python
 print('Mother of Dragons.') # Первая инструкция
 print('Dracarys!') # Вторая инструкция
 ```
 
-💡 Эти строки говорят компьютеру: «Выведи фразу на экран».
-
 Результат выполнения:
 
 ```text
@@ -24,8 +18,7 @@ Dracarys!
 
 ## Порядок имеет значение
 
-Интерпретатор Python исполняет код в строгом порядке — как вы его написали.
-Если поменять местами строки:
+Интерпретатор Python исполняет код в строгом порядке — как вы его написали. Если поменять местами строки:
 
 ```python
 print('Dracarys!')
@@ -44,7 +37,7 @@ Mother of Dragons.
 Обычно инструкции пишутся на отдельных строках, но Python допускает объединение нескольких инструкций в одну строку с помощью ;:
 
 ```python
-print('Mother of Dragons.'); print('Dracarys!')
+print('Mother of Dragons.'); print('Dracarys!');
 ```
 
 Обе версии работают одинаково, но второй вариант хуже читается. В реальных проектах принято писать инструкции построчно — это повышает читаемость и упрощает поддержку кода.

modules/10-basics/50-syntax-errors/ru/README.md

@@ -6,17 +6,18 @@
 
 ## Что такое синтаксическая ошибка?
 
-Синтаксическая ошибка (SyntaxError) — это нарушение грамматических правил языка программирования. Такие ошибки возникают, если код написан с отклонением от ожидаемого формата: не закрыта строка, пропущена скобка, нарушен порядок символов и т.д.
+Синтаксическая ошибка (SyntaxError) — это нарушение правил написания кода (грамматических правил) в конкретном языке программирования. Такие ошибки возникают, если код написан с отклонением от ожидаемого формата: не закрыта строка, пропущена скобка, нарушен порядок символов и т.д.
 
 В отличие от естественных языков, где текст с ошибками можно понять по контексту, в программировании правила строги: даже малейшее отклонение делает код неработоспособным.
 
-Рассмотрим простой пример:
+Рассмотрим простой пример с синтаксической ошибкой:
 
 ```python
+# Правильный вариант такой: print('Hodor')
 print('Hodor)
 ```
 
-В этом коде не закрыта кавычка, и Python не может завершить строку. Попробуем запустить программу:
+В этом коде не закрыта кавычка, что делает программу не корректной с точки зрения синтаксиса. Попробуем запустить программу, то интерпретатор выдаст ошибку:
 
 ```bash
 python index.py
@@ -26,7 +27,7 @@ File "index.py", line 1
 SyntaxError: EOL while scanning string literal
 ```
 
-Интерпретатор сообщает, что строка закончилась, но строковый литерал не завершён — EOL while scanning string literal.
+Текст с непривычки может быть не понятен, но это нормально, чем больше вы будете сталкиваться с такими ошибками, тем больше вы с первого взгляда будете понимать, что произошло.
 
 ## Почему такие ошибки считаются простыми?
 
@@ -37,12 +38,12 @@ SyntaxError: EOL while scanning string literal
 
 Но есть и нюансы:
 
-Интерпретатор не всегда указывает точно то место, где допущена ошибка.
-Иногда проблема находится несколькими строками выше. Например, открытая, но не закрытая скобка на одной строке может «сломать» весь следующий код.
+Интерпретатор не всегда указывает точно то место, где допущена ошибка. Иногда проблема находится несколькими строками выше. Например, открытая, но не закрытая скобка на одной строке может «сломать» весь следующий код.
 
 ## Что делать при синтаксической ошибке?
 
 - Читай сообщение об ошибке. Оно почти всегда содержит полезную информацию.
 - Проверь строку, указанную в сообщении.
 - Проверь строку до неё. Иногда ошибка «спрятана» чуть раньше.
 - Используй [редактор с подсветкой синтаксиса](https://code.visualstudio.com/) — он поможет сразу заметить проблемы (например, незакрытые кавычки или скобки).
+- Поговорить с ИИ, например, нашим ассистентом, во время выполнения заданий

modules/20-arithmetics/25-operator/ru/EXERCISE.md

@@ -1 +1 @@
-Напишите программу, которая посчитает разность между числами `6` и `-81` и выведет ответ на экран.
+Напишите программу, которая посчитает разность (то есть выполнит вычитание `-`) между числами `6` и `-81` и выведет ответ на экран.

modules/20-arithmetics/25-operator/ru/README.md

@@ -15,10 +15,6 @@ print(8 + 2)
 - `8` и `2` — это операнды
 - результат — `10`
 
-## Бинарные операторы
-
-Большинство операторов в Python — бинарные, то есть они работают с двумя операндами: один слева, второй справа. Если вы напишете выражение с одним операндом, например `3 +`, то получите синтаксическую ошибку. Оператор не может работать без всех нужных данных.
-
 ## Унарные операторы
 
 Существуют и унарные операции — они работают с одним операндом. Пример:
@@ -27,14 +23,38 @@ print(8 + 2)
 print(-3)  # => -3
 ```
 
-В этом случае `-` — унарный оператор, а `3` — операнд. Интерпретатор получает команду: «возьми число 3 и измени его знак». Важно понимать: `-3` — это не "отрицательное число как единое целое", а выражение, где `-` — оператор, а `3` — значение.
+В этом случае `-` — унарный оператор, а `3` — операнд. Интерпретатор получает команду: «возьми число 3 и измени его знак».
+
+Оператор `-` может использоваться по-разному. Когда он стоит **между двумя числами**, это операция вычитания:
+
+```python
+print(5 - 2)   # => 3
+print(10 - 7)  # => 3
+```
+
+Здесь `-` берёт первое число и вычитает из него второе.
+
+Эта разница особенно заметна при работе с отрицательными числами. Например:
+
+```python
+# минус на минус дает плюс
+print(5 - -2) # => 7
+```
+
+Сначала мы видим операцию вычитания: `5 - (...)`. Но справа стоит унарный минус `-2`, который превращает `2` в отрицательное число. В итоге получается: `5 - (-2) = 7`.
+
+Таким образом, `-` может означать либо вычитание, либо смену знака числа — всё зависит от того, стоит ли рядом ещё одно число.
+
+Главное, что здесь нужно помнить, поведение и даже сама запись здесь полностью соответствует тому, как мы делали это в школе.
 
 ## Ошибки при вычислениях и парсинге
 
-Если воспринимать `-3` как единое число, можно не заметить, что `-` — это активный оператор. Например:
+Если воспринимать `-3` как единое число, можно не заметить, что `-` — это отдельный оператор со своим приоритетом. Например:
 
 ```python
 print(-3**2)
 ```
 
-Кажется, что (-3) в квадрате даст 9, но результат будет `-9`. Почему? Потому что `-3**2 = -(3**2) = -9`, а не `(-3)**2`. Понимание того, что - — это отдельная операция, помогает избежать таких ошибок.
+На первый взгляд может показаться, что в квадрат возводится `-3`, и результат должен быть `9` (любое число в квадрате становится положительным). Но результат будет `-9`.
+
+Дело в порядке вычислений: сначала выполняется возведение в степень (`**`), а только потом применяется унарный минус. То есть программа считает так: `-(3**2) = -9`.