type annotation

Author: fey

modules/45-logic/15-bool-strings/ru/README.md

@@ -1,4 +1,4 @@
-Операции сравнения работают не только с числами, но и со строками. В этом случае сравнение идёт по алфавитному порядку символов.  
+Операции сравнения работают не только с числами, но и со строками. В этом случае сравнение идёт по алфавитному порядку символов.
 
 ```python
 print("apple" < "banana")   # => True
@@ -7,9 +7,9 @@ print("abc" == "abc")       # => True
 print("hello" != "world")   # => True
 ```
 
-Здесь `"apple" < "banana"`, потому что буква `"a"` в слове *apple* идёт раньше буквы `"b"` в слове *banana*.  
+Здесь `"apple" < "banana"`, потому что буква `"a"` в слове *apple* идёт раньше буквы `"b"` в слове *banana*.
 
-Напишем функцию, которая проверяет, начинается ли слово с заданной буквы. Для этого возьмём первый символ строки и сравним его с нужной буквой.  
+Напишем функцию, которая проверяет, начинается ли слово с заданной буквы. Для этого возьмём первый символ строки и сравним его с нужной буквой.
 
 ```python
 def starts_with(word: str, letter: str) -> bool:
@@ -19,22 +19,22 @@ print(starts_with("apple", "a"))   # => True
 print(starts_with("banana", "a"))  # => False
 ```
 
-Операции сравнения — это такие же выражения, как и арифметические. Это значит, что в них можно подставлять не только готовые значения, но и другие выражения как в примере выше: `word[0]`. Например, вместо числа можно использовать результат работы функции `len`, которая возвращает длину строки:  
+Операции сравнения — это такие же выражения, как и арифметические. Это значит, что в них можно подставлять не только готовые значения, но и другие выражения как в примере выше: `word[0]`. Например, вместо числа можно использовать результат работы функции `len`, которая возвращает длину строки:
 
 ```python
 print(len("apple") > 3)   # => True, потому что len("apple") = 5
 print(len("hi") > 3)      # => False, потому что len("hi") = 2
 ```
 
 В примере выше, сначала выполняется функция `len("apple")`, результатом будет число `5`. Потом это число сравнивается с `3`. То есть порядок вычисления такой:
-1. Сначала считаются аргументы выражения (например, длина строки).  
-2. Потом выполняется операция сравнения.  
+1. Сначала считаются аргументы выражения (например, длина строки).
+2. Потом выполняется операция сравнения.
 
 Так можно комбинировать разные операции, получая более сложные проверки.
 
 ## Полезные предикаты
 
-У строк в Python есть много встроенных методов-предикатов. Они возвращают `True` или `False` и помогают проверять разные свойства строки. Ниже приведены самые часто используемые:  
+У строк в Python есть много встроенных методов-предикатов. Они возвращают `True` или `False` и помогают проверять разные свойства строки. Ниже приведены самые часто используемые:
 
 ```python
 print("hello".startswith("he"))   # True — строка начинается с "he"

modules/45-logic/20-logic-combine-expressions/ru/README.md

@@ -20,7 +20,7 @@
 Скомбинируем в одном выражении логический оператор «проверка равенства» `==` и арифметический оператор `%` и напишем функцию проверки четности:
 
 ```python
-def is_even(number):
+def is_even(number: int) -> bool:
     return number % 2 == 0
 
 print(is_even(10))  # => True
@@ -38,8 +38,8 @@ print(is_even(3))   # => False
 3. Вернем результат
 
 ```python
-def is_first_letter_an_a(string):
-    first_letter = string[0]
+def is_first_letter_an_a(text: string) -> bool:
+    first_letter = text[0]
     return first_letter == 'a'
 
 print(is_first_letter_an_a('orange'))  # => False

modules/45-logic/28-logical-negation/ru/README.md

@@ -8,7 +8,7 @@ not False  # True
 Например, если есть функция, которая проверяет четность числа, то с помощью отрицания можно выполнить проверку нечетности:
 
 ```python
-def is_even(number):
+def is_even(number: int) -> bool:
     return number % 2 == 0
 
 print(is_even(10))      # => True

modules/45-logic/90-logical-expressions/ru/README.md

@@ -1,19 +1,19 @@
-В Python значения разных типов можно использовать напрямую в логических выражениях. При этом они ведут себя как `True` или `False` в зависимости от того, относятся ли к категории **truthy** или **falsy**.  
+В Python значения разных типов можно использовать напрямую в логических выражениях. При этом они ведут себя как `True` или `False` в зависимости от того, относятся ли к категории **truthy** или **falsy**.
 
 ## Falsy и Truthy значения
 
-В Python есть фиксированный набор значений, которые считаются **ложными** (`falsy`):  
+В Python есть фиксированный набор значений, которые считаются **ложными** (`falsy`):
 
-* `0` — любое нулевое число (`0`, `0.0`)  
-* пустая строка `""`  
-* пустые коллекции — `[]`, `{}`, `set()`, `()` (мы пока их не проходили)  
-* специальное значение `None`  
+* `0` — любое нулевое число (`0`, `0.0`)
+* пустая строка `""`
+* пустые коллекции — `[]`, `{}`, `set()`, `()` (мы пока их не проходили)
+* специальное значение `None`
 
-Все остальные значения считаются **истинными** (`truthy`). Например:  
+Все остальные значения считаются **истинными** (`truthy`). Например:
 
-* любое ненулевое число (`1`, `-3.5`)  
-* непустая строка (`"hi"`, `"0"`)  
-* непустые коллекции (`[1]`, `{"a": 1}`, `(0,)`) (будем изучать на Хекслете)  
+* любое ненулевое число (`1`, `-3.5`)
+* непустая строка (`"hi"`, `"0"`)
+* непустые коллекции (`[1]`, `{"a": 1}`, `(0,)`) (будем изучать на Хекслете)
 
 ## Пример с делением на остаток
 
@@ -22,40 +22,40 @@ result = 10 % 2 == 0 and "yes" or "no"
 print(result)   # => "yes"
 ```
 
-Здесь выражение читается так:  
+Здесь выражение читается так:
 
-1. Сначала выполняется арифметика `10 % 2 == 0` → `True`.  
-2. Потом работает `and`: так как слева истина, результатом становится `"yes"`.  
-3. Так как `"yes"` — truthy, оператор `or` возвращает именно его.  
+1. Сначала выполняется арифметика `10 % 2 == 0` → `True`.
+2. Потом работает `and`: так как слева истина, результатом становится `"yes"`.
+3. Так как `"yes"` — truthy, оператор `or` возвращает именно его.
 
 ## Как работают логические выражения
 
-В Python логические выражения возвращают не обязательно `True` или `False`. Они возвращают один из своих операндов:  
+В Python логические выражения возвращают не обязательно `True` или `False`. Они возвращают один из своих операндов:
 
-* оператор `and` возвращает первый falsy-операнд или последний truthy,  
-* оператор `or` возвращает первый truthy-операнд или последний falsy.  
+* оператор `and` возвращает первый falsy-операнд или последний truthy,
+* оператор `or` возвращает первый truthy-операнд или последний falsy.
 
-Поэтому результатом может быть строка, число или любой другой объект, участвующий в выражении.  
+Поэтому результатом может быть строка, число или любой другой объект, участвующий в выражении.
 
 ## Примеры
 
 ```python
-print(7 % 2 == 0 and "even" or "odd")  
+print(7 % 2 == 0 and "even" or "odd")
 # => "odd"
 
-print(("" and "not empty") or "empty")  
+print(("" and "not empty") or "empty")
 # => "empty"
 
-print(("hello" and "not empty") or "empty")  
+print(("hello" and "not empty") or "empty")
 # => "not empty"
 
-print((-5 > 0 and "positive") or "non-positive")  
+print((-5 > 0 and "positive") or "non-positive")
 # => "non-positive"
 ```
 
 ## Использование в функциях
 
-Особенность truthy и falsy значений удобно применять в функциях. Например, можно написать функцию, которая возвращает текст, если он непустой, или значение по умолчанию, если строка пустая.  
+Особенность truthy и falsy значений удобно применять в функциях. Например, можно написать функцию, которая возвращает текст, если он непустой, или значение по умолчанию, если строка пустая.
 
 ```python
 def get_text_or_default(text: str, default: str = "empty") -> str:
@@ -65,7 +65,7 @@ print(get_text_or_default("hello"))   # => "hello"
 print(get_text_or_default(""))        # => "empty"
 ```
 
-Здесь выражение `text or default` работает так:  
+Здесь выражение `text or default` работает так:
 
-* если `text` непустой (truthy), функция вернёт его,  
+* если `text` непустой (truthy), функция вернёт его,
 * если `text` пустой (falsy), функция вернёт `default`.