Added more examples

Author: artinnok

README.md

@@ -15,6 +15,7 @@
 - [Файлы `__init__.py`](#файлы-__init__py)
 - [Докстринги](#докстринги)
 - [Документация к REST API](#документация-к-rest-api)
+- [Про код](#про-код)
 - [Про Pull Request](#про-pull-request)
 - [Размер Pull Request](#размер-pull-request)
 
@@ -187,6 +188,54 @@ from some.absolute.path import foo, bar
 **Почему?** Потому что это один из распространенных форматов для документирования REST API, которая вышла из Swagger. Данный формат документации поддерживается большим количеством клиентов (Swagger, Postman, Insomnia Designer и многие другие). Также, рукописная документация имеет свойство быстро устаревать, а документация, которая генерируется напрямую из кода позволяет не думать о постоянном обновлении документации.
 
 
+## Про код
+**1 действие ~ 1 строка**
+
+На каждой строке надо постараться делать ровно одно действие. 
+
+Плохо ❌:
+```python
+# 1. 3 действия на одной строке - 3 вызова функции
+foo_result = foo(bar(spam(x)))
+
+# 2. 3 действия на одной строке - вызов функции foo, get_c, from_b
+foo_result = foo(a=a, b=b, c=get_c(from_b())
+
+# 3. 3 действия на одной строке - фильтрация по аргументам, условное получение элементов (через or), вызов метода .value
+result = [(a.value() or A, b or B) for a, b in iterator if a < b]
+
+# 4. 4 действия на одной строке - из библиотеки / переменной foo идет получение атрибута bar, получение атрибута spam, получение атрибута hello и вызов calculate_weather
+result = calculate_weather(foo.bar.spam.hello)
+```
+
+Хорошо ✅:
+```python
+# 1. делаем поочередный вызов каждой функции
+spam_result = spam(x)
+bar_result = bar(spam_result)
+foo_result = foo(bar_result)
+
+# 2. поочередно вызываем функции, результат пишем в переменную и используем ее при вызове foo
+from_b_result = from_b()
+c = get_c(from_b_result)
+foo_result = foo(a=a, b=b, c=c)
+
+# 3. последовательно проводим действия над списком - вначале фильтруем, вызываем метод .value у a, выбираем между элементами (or)
+filtered_result = ((a, b) for a, b in iterator if a < b)
+intermediate_result = ((a.value(), b) for a, b in filtered_result)
+result = [(a or A, b or B) for a, b in intermediate_result]
+
+# 4 . последовательно читаем атрибуты bar, spam, hello и вызываем функцию calculate_weather
+bar = foo.bar
+spam = bar.spam
+hello = spam.hello
+result = calculate_weather(hello)
+```
+
+
+**Почему?** Потому что код становится более читабельным, не нужно исполнять несколько выражений в голове во время чтения кода. Разбитый до простых атомных операций код воспринимается гораздо лучше, чем сложный уан-лайнер. Постарайтесь упростить свой код настолько, насколько это возможно - код чаще читается, чем пишется.
+
+
 ## Про Pull Request
 **1 Pull Request = 1 issue**