1.2.4: expand theory across all 158 days

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 Формат основан на [Keep a Changelog](https://keepachangelog.com/).
 
+## [1.2.4] — 2026-08-01
+
+### Changed
+- Теория всех учебных дней (158) расширена до ~350–500 слов: ментальная модель, зачем нужно дальше, пример, типичная ошибка, связь с практикой
+- Часы дня пересчитаны после расширения теории (`rebalance-weeks.py`)
+
 ## [1.2.3] — 2026-08-01
 
 ### Fixed

README.md

@@ -19,7 +19,7 @@
   <img src="https://img.shields.io/badge/длительность-22%20недели-3dd6c6?style=flat-square" alt="22 weeks" />
   <img src="https://img.shields.io/badge/нагрузка-6--7%20ч%2Fдень-6eb5ff?style=flat-square" alt="6-7h per day" />
   <img src="https://img.shields.io/badge/стек-full--stack-8b95a5?style=flat-square" alt="full-stack" />
-  <img src="https://img.shields.io/badge/версия-1.2.3-8b95a5?style=flat-square" alt="v1.2.3" />
+  <img src="https://img.shields.io/badge/версия-1.2.4-8b95a5?style=flat-square" alt="v1.2.4" />
 </p>
 
 ---

docs/w/00.html

@@ -29,9 +29,12 @@ <h2 id="week-00-day-0-1">День 0.1: Инструменты</h2>
 <strong>Связь с проектом:</strong> стабильная среда для всех следующих недель</p>
 </blockquote>
 <h3>Теория</h3>
-<p>Веб-разработка начинается не с кода, а со <strong>среды</strong>: редактор, браузер с DevTools, терминал, Git. Эти инструменты останутся с вами на годы.</p>
-<p><strong>VS Code</strong> — редактор с встроенным терминалом и Git. <strong>Chrome DevTools</strong> — Elements (DOM/CSS), Console (ошибки JS), Network (запросы). <strong>Git</strong> — история изменений; без него нет портфолио.</p>
-<p><strong>Ключевая мысль:</strong> стабильная среда важнее скорости «сразу писать код».</p>
+<p>Веб-разработка начинается не с кода, а со <strong>среды</strong>: редактор, браузер с DevTools, терминал, Git. Эти инструменты останутся с вами на годы, поэтому час, потраченный сегодня на настройку, окупится десятки раз позже.</p>
+<p>Удобная мысленная модель: редактор — мастерская, где вы создаёте вещь; браузер с DevTools — рентген, который показывает, что получилось на самом деле; терминал — пульт, откуда команды отдаются инструментам напрямую, а не кликами мыши; Git — машина времени, которая помнит каждую версию вашей работы.</p>
+<p><strong>VS Code</strong> — редактор с встроенным терминалом и подсветкой Git-изменений прямо в файлах. <strong>Chrome DevTools</strong> — три вкладки на каждый день: Elements показывает живое дерево DOM и применённые CSS-правила, Console выводит ошибки JavaScript, Network — что загрузила страница и сколько это заняло. <strong>Git</strong> — история изменений; без него нет портфолио и нет пути назад, если что-то сломалось.</p>
+<p>Пример: через несколько недель вы случайно удалите важный кусок CSS и не заметите это сразу — <code>git diff</code> покажет ровно те строки, что изменились со вчерашнего коммита, и восстановить код можно за секунды вместо часа гаданий.</p>
+<p>Частая ошибка новичков — писать код без Git «чтобы не тратить время на настройку», откладывая репозиторий «на потом, когда будет что показать». Тогда первые недели прогресса нигде не задокументированы. Такая же ошибка — отлаживать вёрстку методом «поменял файл — обновил страницу — посмотрел», хотя Elements с редактированием стилей на лету делает это быстрее.</p>
+<p><strong>Ключевая мысль:</strong> стабильная среда важнее скорости «сразу писать код» — сегодняшняя практика единственный раз в маршруте посвящена только настройке, чтобы дальше ничего не отвлекало от обучения.</p>
 <p><strong>Читать:</strong> <a href="#start">Как начать</a> — таблица инструментов.</p>
 <h3>Практика (полный трек)</h3>
 <ol>
@@ -60,9 +63,12 @@ <h2 id="week-00-day-0-2">День 0.2: GitHub и свой learning-log</h2>
 <strong>Связь с проектом:</strong> публичное портфолио с дня 1 недели 1</p>
 </blockquote>
 <h3>Теория</h3>
-<p>Публичный <code>learning-log</code> — портфолио <strong>в процессе</strong>. Рекрутер видит дисциплину: коммиты, сообщения, рост по неделям — не только финальный zip.</p>
-<p>Репозиторий создаёте <strong>под своим аккаунтом</strong>, пустой (без README от GitHub), затем клонируете себе. Не клонируйте чужой learning-log — это должен быть ваш граф коммитов.</p>
-<p><strong>Ключевая мысль:</strong> репозиторий появляется до первой строки HTML.</p>
+<p>Публичный <code>learning-log</code> — портфолио <strong>в процессе</strong>, а не готовая витрина. Рекрутер, который откроет ваш GitHub через полгода, видит не только финальный код, но и дисциплину: регулярные коммиты, внятные сообщения, заметный рост качества от недели 1 к неделе 20. Это рассказывает историю лучше, чем строчка в резюме.</p>
+<p>Мысленная модель: репозиторий — дневник разработчика, а не архив готовых работ. Каждый коммит — запись «что сделано и зачем», а вместе они складываются в график активности на странице профиля GitHub. Пустые недели в этом графике так же красноречивы, как и активные.</p>
+<p>Репозиторий создаёте <strong>под своим аккаунтом</strong>, пустым (без README, лицензии и <code>.gitignore</code> от GitHub — их вы добавите сами локально, чтобы первый коммит был осмысленным, а не автосгенерированным), затем клонируете себе на компьютер. Важно не путать: клонировать нужно <strong>свой</strong> пустой репозиторий, а не чужой существующий <code>learning-log</code> — иначе история коммитов будет принадлежать другому человеку, и смысл портфолио теряется.</p>
+<p>Почему это важно для всего маршрута: начиная с недели 1 каждый день заканчивается коммитом в эту же папку. Если репозиторий настроен неправильно сегодня — с чужой историей или без <code>.gitignore</code> — проблему придётся решать посреди недели 1, отвлекаясь от HTML.</p>
+<p>Частое заблуждение — думать, что показывать портфолио стоит только после «идеального» результата, поэтому можно закоммитить всё одним большим коммитом в конце. На деле частые маленькие коммиты с понятными сообщениями (<code>feat: add contact form</code>, а не <code>fix</code>) сами по себе сигнал профессионализма — и заметны раньше, чем содержимое кода.</p>
+<p><strong>Ключевая мысль:</strong> репозиторий появляется до первой строки HTML — сегодняшняя практика это подтверждает: вы создаёте <code>learning-log</code>, <code>.gitignore</code> и <code>README.md</code> ещё до того, как напишете хоть один тег.</p>
 <h3>Практика (полный трек)</h3>
 <ol>
 <li>Аккаунт GitHub (если нет) + 2FA по возможности</li>
@@ -101,7 +107,8 @@ <h2 id="week-00-day-0-3">День 0.3: Как учиться по маршрут
 <strong>Связь с проектом:</strong> выбрать полный или лайт-трек до недели 1</p>
 </blockquote>
 <h3>Теория</h3>
-<p>Каждый учебный день недель 1–22:</p>
+<p>Прежде чем нырять в HTML на неделе 1, полезно понять устройство самого маршрута — это экономит время в первый рабочий день. Мысленная модель: маршрут — 22 «спринта» по неделе, а не линейный курс видео. Каждая неделя даёт один законченный проект, и пропущенный день ломает не столько расписание, сколько внутреннюю логику: практика четверга опирается на код, написанный в понедельник.</p>
+<p>Каждый учебный день недель 1–22 устроен одинаково:</p>
 <table>
 <thead>
 <tr>
@@ -132,8 +139,9 @@ <h3>Теория</h3>
 </tr>
 </tbody>
 </table>
-<p><strong>Полный трек</strong> (~5–7 ч/день): максимум глубины. <strong>Лайт</strong> (~3–4 ч): теория + лайт-практика + Git; проект недели — в урезанном DoD из каталога.</p>
-<p>Протокол «анти-вайбкодер»: ИИ объясняет концепцию или ревьюит <strong>ваш</strong> код. Не пишет за вас.</p>
+<p><strong>Полный трек</strong> (~5–7 ч/день): максимум глубины, все пункты практики, углублённое ревью. <strong>Лайт</strong> (~3–4 ч): теория читается полностью, практика — только MVP-подмножество, коммит обязателен; проект недели сдаётся в урезанном DoD (Definition of Done) из каталога проектов — согласованный меньший набор требований, а не «сделаю потом».</p>
+<p>Почему это важно для следующих недель: если сегодня не разобраться, чем полный трек отличается от лайт, велик риск на неделе 5 обнаружить накопившееся отставание, которое сложно объяснить — просто не был понятен ожидаемый объём практики. Пример: студент на лайт-треке, который в день 3 недели 1 делает только MVP-пункты вместо всех пунктов «полного трека», не отстаёт — он следует своему треку, если проект недели в итоге собран по лайт-DoD.</p>
+<p>Протокол «анти-вайбкодер» — отдельное важное правило: ИИ-ассистент в этом маршруте объясняет концепцию или ревьюит <strong>уже написанный вами</strong> код, но не пишет решение за вас. Частая ошибка новичков — попросить ИИ «сделай форму валидации» и скопировать ответ: код появится, а навык — нет, и это станет заметно на итоговом проекте. Сегодняшняя практика — прочитать introduction и каталог проектов, чтобы осознанно выбрать трек, а не выяснять правила на ходу в понедельник.</p>
 <p><strong>Читать:</strong>
 - <a href="https://github.com/krwg/web-roadmap/blob/main/roadmap/introduction.md">Введение</a>
 - <a href="#projects">Каталог 22 проектов</a></p>