update content

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

Author: mokevnin

modules/25-strings/10-quotes/ru/EXERCISE.md

@@ -1,10 +1,4 @@
-Напишите программу, которая выведет на экран:
-
-```text
-"Khal Drogo's favorite word is "athjahakar""
-```
-
-Программа должна вывести на экран эту фразу в точности. Обратите внимание на кавычки в начале и в конце фразы:
+Напишите программу, которая выведет на экран в точности как она записана:
 
 ```text
 "Khal Drogo's favorite word is "athjahakar""

modules/25-strings/10-quotes/ru/README.md

@@ -1,6 +1,6 @@
-В этом уроке разберёмся, что такое строка и какую роль играют кавычки в коде.
+Строки в программировании на Python используются очень часто и в самых разных ситуациях. С их помощью мы работаем с текстом: выводим сообщения на экран, обрабатываем пользовательский ввод, читаем данные из файлов, формируем запросы к базам данных или внешним системам.
 
-Строка — это просто набор символов, заключённый в кавычки. Посмотрим на примеры:
+С точки зрения Python, строка — это просто набор символов, заключённый в кавычки. Посмотрим на примеры:
 
 ```python
 'Hello'
@@ -15,10 +15,39 @@
 - `'Hello'` и `'Goodbye'` — это строки из нескольких символов.
 - `'G'` — строка из одного символа.
 - `' '` — строка, состоящая из одного пробела.
-- `''` — пустая строка, в ней нет ни одного символа.
+- `''` — пустая строка, в ней нет ни одного символа. Играет такую же роль, как 0 в математике
 
 То есть всё, что находится внутри кавычек, считается строкой: даже если там только пробел или вообще ничего нет.
 
+Если вывести строки на экран, то `'Hello'` и `'Goodbye'` будут хорошо заметны. Но `'` ' и `''` могут сбивать с толку: пустая строка ничего не покажет, а строка с пробелом покажет «пустое место», которое визуально сложно отличить. При этом Python чётко различает их: пустая строка — это отсутствие символов, а строка с пробелом содержит конкретный символ пробела.
+
+Этим языки программирования отличаются от разговорных языков: здесь нет места для интерпретаций. В обычных языках человек может по-разному понять сказанное, уловить смысл даже при неточностях или пропусках. В коде такого не бывает — строка всегда трактуется однозначно.
+
+Контрольный вопрос. Это одинаковые строки или нет?
+
+```python
+'хекслет'
+' хекслет'
+```
+
+## 📚 Терминология: строка или строчка?
+
+В программировании есть терминологическая ловушка:
+
+- Строка (string) — это тип данных (то что разбирали выше), например 'hello'.
+- Строчка (line) — это строка текста в файле или в коде.
+
+Например, в коде ниже есть строчка, но не строка:
+
+```python
+print(5)
+```
+
+Чтобы избежать путаницы, в этом курсе мы будем использовать:
+
+- Строка — когда говорим о типе данных.
+- Строчка — когда речь идёт о строках кода.
+
 ## Одинарные и двойные кавычки
 
 В Python строки можно записывать как в одинарных, так и в двойных кавычках:
@@ -30,11 +59,11 @@ print("Hello")
 
 Оба варианта работают одинаково. Главное — использовать один и тот же тип кавычек в начале и в конце строки.
 
-Хотя Python поддерживает оба варианта, по умолчанию принято использовать одинарные кавычки `'`, если внутри строки не требуется двойных. Этого стиля придерживается официальный стандарт _PEP8_ и линтер _Ruff_, который мы используем на платформе. Он может автоматически заменить двойные кавычки на одинарные там, где это возможно.
+Хотя Python поддерживает оба варианта, по умолчанию принято использовать одинарные кавычки `'`, если внутри строки не требуется двойных. Этого стиля придерживается официальный стандарт оформления кода *PEP8*.
 
 ## Проблема с кавычками внутри строки
 
-Представьте, что вы хотите напечатать строку _Dragon's mother_. В ней есть апостроф (_'s_) — это тот же символ, что и одинарная кавычка. Попробуем так:
+Представьте, что вы хотите напечатать строку *Dragon's mother*. В ней есть апостроф (*'s*) — это тот же символ, что и одинарная кавычка. Попробуем так:
 
 ```python
 print('Dragon's mother')
@@ -61,14 +90,14 @@ print('He said "No"')
 Dragon's mother said "No"
 ```
 
-В этом случае, чтобы Python не спутал кавычки внутри строки с внешними, используют символ экранирования — обратный слэш `\`. Он говорит интерпретатору: следующий за ним символ — часть строки, а не управляющий символ.
+В этом случае чтобы Python не спутал кавычки внутри строки с внешними, используют символ экранирования — обратный слэш `\`. Он говорит интерпретатору: следующий за ним символ — часть строки, а не управляющий символ.
 
 ```python
 print("Dragon's mother said \"No\"")
 # => Dragon's mother said "No"
 ```
 
-В этом примере мы экранируем двойные кавычки внутри строки, заключённой в двойные кавычки.
+Здесь мы экранируем двойные кавычки внутри строки, заключённой в двойные кавычки.
 
 Обратите внимание: Python воспринимает `\"` как один символ — кавычку, а не два символа.
 То же самое касается `\'`, `\\`, `\n` и других управляющих последовательностей — они выглядят как два символа в коде, но в строке считаются за один.

modules/25-strings/15-escape-characters/ru/README.md

@@ -1,20 +1,18 @@
-Допустим, мы хотим вывести диалог:
+Допустим, мы хотим вывести текст ниже в две строчки:
 
 ```text
 - Are you hungry?
 - Aaaarrrgh!
 ```
 
-Попробуем записать его как одну строку:
+Если мы просто передадим этот текст в `print()`, то Python напечатает все в одну строчку:
 
 ```python
 print("- Are you hungry?- Aaaarrrgh!")
 # => - Are you hungry?- Aaaarrrgh!
 ```
 
-Получилось не то что нужно: обе реплики слились в одну строку. Чтобы каждая из них начиналась с новой строки, нужно указать Python'у сделать перевод строки — то есть «нажать Enter».
-
-Для этого используется специальный управляющий символ `\n`:
+Чтобы каждая из них начиналась с новой строки, нужно добавить перевод строки — то есть «нажать Enter». Технически это реализуется через добавление специальных символов, в данном случае `\n`. Да, это не опечатка. Несмотря на то, что мы видим здесь два символа, с точки зрения Python это один символ.
 
 ```python
 print("- Are you hungry?\n- Aaaarrrgh!")
@@ -41,28 +39,30 @@ print("- Are you hungry?\n- Aaaarrrgh!")
 
 Принтеры, редакторы и интерпретаторы Python понимают `\n` как команду начать строку с новой строки.
 
-## Другие управляющие символы
-
-Кроме `\n`, в Python есть и другие специальные последовательности:
-
-- `\t` — табуляция (эквивалент клавиши Tab)
-- `\r` — возврат каретки (используется в Windows, но редко применяется в Python-коде)
-- В программировании чаще всего используют именно \n — его достаточно для большинства задач.
-
 ## Примеры использования `\n`
 
+Местоположение `\n` меняет итоговый вывод:
+
 ```python
-print("Gregor Clegane\nDunsen\nPolliver\nChiswyck")
+print("Hello\nWorld")
+# Hello
+# World
+
+print("Hello \nWorld")
+# Hello 
+# World  (в конце первой строки есть пробел)
+
+print("Hello\n World")
+# Hello
+#  World  (во второй строке в начале пробел)
+
+print("Hello\n\nWorld")
+# Hello
+#
+# World  (пустая строка между ними)
 ```
 
-Результат:
-
-```text
-Gregor Clegane
-Dunsen
-Polliver
-Chiswyck
-```
+Пробелы до или после `\n` также учитываются: Python воспринимает их как обычные символы и отображает в выводе.
 
 Вы также можете вставлять `\n` в любую часть строки — до, после или даже использовать его отдельно:
 
@@ -80,13 +80,28 @@ First line
 Second line
 ```
 
+## Как вывести сам символ `\n`
+
+
+Так как `\n` в Python — это управляющая последовательность, он не отображается напрямую. Если вам нужно вывести именно символы `\` и `n`, а не перевод строки, их нужно экранировать. Для этого перед обратным слешем добавляют ещё один слеш:
+
+```python
+print("Hello\\nWorld")
+# Hello\nWorld
+```
+
+В этом случае Python понимает `\\` как обычный обратный слеш и показывает строку без перевода строки.
+
+## Другие управляющие символы
+
+Кроме `\n`, в Python есть и другие специальные последовательности:
+
+- `\t` — табуляция (эквивалент клавиши Tab)
+- `\r` — возврат каретки (используется в Windows, но редко применяется в Python-коде)
+- В программировании чаще всего используют именно `\n` — его достаточно для большинства задач.
+
+
 ## Важные детали
 
 - '\n' — один символ, несмотря на то, что в коде он записан как два (\ и n).
-- Если вы хотите вывести символы \n буквально (как текст), используйте двойной обратный слэш `\\n`:
-    ```python
-    print("Joffrey loves using \\n")
-    # => Joffrey loves using \n
-    ```
-
 - На Windows по умолчанию используется комбинация \r\n, но в Python (и вообще в кроссплатформенной разработке) принято использовать только \n, чтобы избежать проблем при переносе кода между системами.

modules/33-data-types/40-primitive-data-types/ru/README.md

@@ -77,21 +77,3 @@ print(10.234)  # => 10.234
 - float (рациональное число)
 
 называются примитивными — они встроены прямо в язык. Существуют и составные типы: списки, словари, кортежи и другие. С ними мы познакомимся позже. Более того, в Python можно создавать и свои собственные типы (например, классы), но для начала важно хорошо разобраться с примитивами.
-
-## 📚 Терминология: строка или строчка?
-
-В программировании есть терминологическая ловушка:
-
-- строка (string) — это тип данных, например 'hello'
-- строчка (line) — это строка текста в файле или в коде
-
-Например, в коде ниже есть строчка, но не строка:
-
-```python
-print(5)
-```
-
-Чтобы избежать путаницы, в этом курсе мы будем использовать:
-
-- строка — когда говорим о данных типа str;
-- строчка — когда речь идёт о строках кода (lines).