WIP

Author: tabuna

README.md

@@ -1,55 +1,11 @@
 # 🎩 «Денди-код»
 
-> Кулинарная книга (cookbook) по выразимому, аккуратному коду: короткие рецепты с примерами «до/после» и понятными шагами внедрения.
+> Руководство о том, как писать код с аккуратностью, уважением к читателю и стилем — даже если вы новичок.
 
 
 ## 📘 О книге
 
-Краткая и практичная книга о том, как писать понятный и аккуратный код с примерами на PHP. Приёмы универсальны и легко переносятся на любой объектно‑ориентированный язык. Вместо теории — конкретные «рецепты»: один приём — одна проблема — один понятный результат.
-
-- Фокус на визуальной читаемости и «голосе» кода
-- Короткие главы, минимум «воды» и спорных догм
-- Примеры «плохо/хорошо», которые можно повторить за 10–15 минут
-
-
-## 👥 Кому подойдёт
-
-- Начинающим — чтобы быстро выровнять стиль и уверенно читать чужой код
-- Опытным — как набор проверенных практик и согласованный язык команды
-- Тимлидам — как база для онбординга, код‑ревью и внутренних соглашений
-
-
-## 🧑‍🍳 Как пользоваться
-
-### В одиночку
-- Откройте любую главу из `/content` → примените один рецепт к своему проекту
-- Начните с форматирования и имён, затем двигайтесь к условиям/исключениям и тестам
-- Фиксируйте прогресс чек‑листом pull‑реквестов: «минимум один рецепт на PR»
-
-### В команде
-- Включите главы как основу для внутренних правил (style guide) и ревью‑чек‑листов
-- Автоматизируйте «механику» (линтеры, автоформатирование), обсуждайте «смысл» в ревью
-- Используйте главы для онбординга: по 1–2 рецепта на спринт, с короткими демо
-
-
-## 📚 Содержание (выборочно)
-
-- [Форматирование](./content/005-code-style.md)
-- [Код должен дышать](./content/006-code-breath.md)
-- [Именование](./content/007-naming.md)
-- [Магические значения](./content/008-magic-value.md)
-- [Размер имеет значение](./content/009-size.md)
-- [Без лишних движений](./content/010-no-nonsense.md)
-- [Ранний выход](./content/011-early-exit.md)
-- [Управляющие конструкции](./content/012-conditions.md)
-- [Аргументы](./content/013-arguments.md)
-- [Обработка ошибок](./content/014-exceptions.md)
-- [Комментарии](./content/015-comments.md)
-- [Не бойся удалять код](./content/016-remove.md)
-- [Тесты](./content/017-tests.md)
-- [Играй по правилам (фреймворки)](./content/018-frameworks.md)
-- [Не отказывайтесь от будущего (обновления)](./content/019-upgrade.md)
-- [Второй пилот — не капитан (LLM)](./content/020-copilot.md)
+Краткая и практичная книга о том, как писать понятный и аккуратный код с примерами на PHP. Книга не уходит в теоретические дебри, не спорит о вкусе и не переоценивает значение философии чистоты. Она фокусируется на самом первом шаге к хорошему коду — **его визуальной читаемости**. Здесь вы найдёте рекомендации, которые можно и нужно применять сразу на практике.
 
 
 ## 🗂 Структура репозитория
@@ -62,25 +18,22 @@
 
 ## ❓ FAQ
 
-**Когда будет готова книга?**  
-Я пока не уверен в точных сроках. Нажмите на «колокольчик» рядом со ⭐️, чтобы получать уведомления.
-
-**Я не пишу на PHP — будет ли книга полезна?**  
-Да. Принципы универсальны, примеры легко читаются и переносятся в любой ООП‑язык.
+**Когда будет готова книга?**   
+Я пока не уверен в точных сроках. Просто нажмите на колокольчик рядом с кнопкой звезды, чтобы получать уведомления о новых изменениях!
 
-**Можно ли использовать книгу для команды?**  
-Да. Это cookbook: берёте рецепт → добавляете в чек‑лист ревью → автоматизируете там, где возможно.
+**Я не пишу на PHP — будет ли книга полезна для меня?**   
+Определённо! Хотя примеры приведены на PHP, все советы универсальны и легко применимы к любому объектно-ориентированному языку программирования.
 
-**Как предложить идею или правку?**  
-Создайте issue/PR или напишите автору в [Telegram](https://t.me/tabuna).
+**Могу ли я предложить свои идеи для книги?**     
+Конечно! Если у вас есть идеи или предложения, буду рады их услышать. Пожалуйста, напишите мне в [Telegram](https://t.me/tabuna).
 
-**Будет ли электронная версия?**  
-Да, PDF и, возможно, другие форматы.
+**Будет ли книга доступна в электронном формате?**     
+Да, книга будет доступна в формате PDF и, возможно, других форматах.
 
 
 ## ✨ Поддержите проект
 
-Если вам близка идея вдумчивого и человечного программирования — поставьте ⭐️ репозиторию.  
+Если вам близка идея вдумчивого и человечного программирования — поставьте ⭐️ репозиторию.
 Это поможет книге найти своего читателя и ускорит её выпуск.
 
 Если хотите поддержать проект финансово — это можно [сделать прямо сейчас](https://laravel.su/donate). Спасибо! 💖
@@ -89,4 +42,4 @@
 
 Я буду рад, если вы поможете рассказать о книге.  
 Поделитесь ею с друзьями, коллегами или в любимом чате — пусть о ней узнают те, кому это может пригодиться.  
-Для меня это не менее ценно, чем ⭐️ или донат.
+Для меня это не менее ценно, чем ⭐️ или донат.