WIP

Author: tabuna

content/002-readme.md

@@ -12,10 +12,12 @@
 На практике `README` часто либо отсутствует, либо существует лишь как формальность.
 Такое встречается в репозиториях компаний любого масштаба.
 
-Например, в корне может лежать пустой или шаблонный `README`, созданный автоматически при инициализации — и на этом всё.
-Иногда файл содержит только заголовок `# ProjectName`, без единого слова о сути проекта. А в худшем случае `README`
+Например, в корне может лежать пустой или шаблонный файл `README`, созданный автоматически при инициализации — и на этом всё.
+Иногда файл содержит только заголовок   
+`# ProjectName`, без единого слова о сути проекта. А в худшем случае `README`
 вообще нет, зато рядом находятся десятки разрозненных скриптов и несколько почти одинаковых конфигурационных файлов:
-`config_old.php`, `config_bak.php`, `config_real_final.php`.
+`config_old.php`, `config_bak.php`,   
+`config_real_final.php`.
 
 Что с этим делать?
 Начать с простого — представить, что репозиторий открыл разработчик, который впервые видит этот проект.
@@ -87,6 +89,7 @@ make reset-db
 ```shell
 # Для запуска всех тестов:
 vendor/bin/phpunit
+
 # или для запуска тестов в определённой тестовой группе:
 vendor/bin/phpunit --testsuite=Browser
 ```
@@ -103,6 +106,8 @@ vendor/bin/phpunit --testsuite=Browser
 Допустим, вы работаете над внутренним проектом Weather — платформой для анализа метеоданных.
 Вам поручили реализовать класс, вычисляющий лунную фазу, чтобы добавить его в блок астрономического прогноза.
 
+В какой директории вы создадите этот класс:
+
 - В `components`?
 - В `modules`?
 - В `services`?

content/003-big.md

@@ -9,7 +9,7 @@
 
 <div style="page-break-after: always;"></div>
 
-Его используют:
+Его по умолчанию используют:
 
 - Laravel (PHP)
 - Django (Python)

content/004-communication.md

@@ -41,7 +41,7 @@
 > Я ПРОГРАМИСТ с БОЛЬЩИМ апытом делал сайты и приложения для интирнета. Пишу код на джаве и пхп ещо умею с питон и руби.
 > Работал в разны места делал всьо што гаварили.
 > Харашо разбераюсь в компютерах и серварах, могу делать апдейт и чинить баги.
-> Если вазьмёте меня, не пажелеете, я осен стараюс.
+> Если вазьмёте меня, не пажелеете, я осен-осен стараюс.
 
 Дочитывать не хочется, а приглашать на собеседование — тем более.
 Даже если письмо будет оформлено без ошибок, оно всё равно может произвести не лучшее впечатление:

content/006-code-breath.md

@@ -13,7 +13,6 @@
 <div style="page-break-after: always;"></div>
 
 Плохая новость:
-> {warning}
 > **Ни один автоматический инструмент форматирования не научит ваш код дышать.**
 
 Рассмотрим пример:

content/007-naming.md

@@ -47,7 +47,7 @@ class Order extends Controller
     {
         // ...
         foreach ($zakazy as $tovar) {
-                $product->otpravka($tovar);
+            $product->otpravka($tovar);
         }
         // ...
     }
@@ -101,7 +101,7 @@ $user = User::find($id);
 // Плохо [✗]
 class UsrCtrl extends Ctrl {
     public function f() {
-            // ...
+        // ...
     }
 }
 ```
@@ -116,7 +116,7 @@ class ProfileController extends Controller
 {
     public function show()
     {
-            // ...
+        // ...
     }
 }
 ```
@@ -127,7 +127,7 @@ class ProfileController extends Controller
 
 Некоторые даже добавляют:
 
-> «Пусть имя будет длинным — это сделает код понятнее».
+> «Пусть имя будет длинным — это сделает код самодокументированным и более понятным».
 
 Нет. Не делает.
 Особенно если это имя — дымовая завеса над тем, что в коде нет ни логики, ни смысла.

content/013-arguments.md

@@ -145,6 +145,9 @@ $fileSystem
 Стоит отдельно упомянуть, что многие разработчики и известные авторы, например, Роберт Мартин — автор "Чистого кода",
 считают использование булевых аргументов признаком плохого тона. И предлагают создавать отдельный метод вместо передачи
 булева значения.
+
+<div style="page-break-after: always;"></div>
+
 Например, вместо:
 
 ```php
@@ -188,8 +191,6 @@ $fileSystem->reWrite(
 // Плохо [✗]
 class ExcludeList
 {
-    private array $list = [];
-
     public function add(
         string $itemName,
         string $itemIdentityName,
@@ -217,8 +218,6 @@ class ExcludeList
 // Хорошо [✓]
 class ExcludeList
 {
-    private array $list = [];
-
     public function add(Model $model): static
     {
         $key = $model->getKey();