inspiritum · inspiritum · Jan 27, 2026 · Jan 27, 2026 · Jan 27, 2026
diff --git a/README.md b/README.md
@@ -30,3 +30,34 @@
 
 2.4) В корне репозитория появится раздел Deployments со ссылкой на ghpages  
 (ее так же можно найти в пункте в разделе `Settings > Pages`)
+
+### Шаг 3 - добавить папку docs/
+
+> Почему именно `docs/` ?
+> - github видит ее по умолчанию и это отличный пример для демонстрации  
+> (мы все еще не настраиваем "сложные вещи" но уже работаем с директорией проекта)
+> - работа с папкой `docs/` будет продемонстрирована в следующих шагах
+
+3.1) Создать в корне проекта папку `docs/` и перенести в нее все рабочией файлы сайта  
+- т.е. `index.html`, `styles.css`, `script.js` и т.д. (например картинки)  
+- документацию, конфиги и прочее (что не влияет на работу сайта) переносить не нужно
+
+> Вне зависимости от структуры фронтенд проекта и применямых технологий папка `docs/` это стандарт
+
+3.2) Т.к. адрес `index.html` в файловой структуре теперь поменялся то нужно изменить и настройки ghpages  
+- перейти в раздел `Settings > Pages`
+- в поле `Folder`  (`Build and deployment` / `Branch`) обновить адрес папки с сайтом (`docs/`)
+- если текущие изменения в новой ветке, то надо будет выбрать актуальную ветку
+- не забыть сохранить внесенные изменения и подождать какое-то время (обычно до 30 секунд)
+
+3.3) Проверить раздел `Deployments`  
+- ссылку на него можно найти на титульной странице репозитория (раздел `Code` и справа внизу `Deployments`)  
+- или сразу перейти на него по прямой ссылке `https://github.com/<USERNAME>/<PROJECT>/deployments`
+- важно проверить, что после внесенных изменений появился новый deployment в списке
+
+3.4) Для лучше демонстрации того, что deployment ТОЧНО работает и ТОЧНО выгружает last updates,  
+можно добавить какие-то незнавительные изменения (например, в каком-то тексте в `index.html`)
+(после этого опять запушить в ветку, опять подождать, опять проверить список deployments)
+
+3.5) Если deployment прошел а на странице ghpages (на стенде) новых изменений нет,  
+то проблема может быть в кеше браузера (тогда помогает hard realod или режим incognito)
diff --git a/index.html → docs/index.html b/index.html → docs/index.html
@@ -10,8 +10,8 @@
     <body class="page">
         <header class="page__header header">
             <div class="container">
-                <h1 class="header__name">Иван Иванов</h1>
-                <p class="header__role">Frontend Developer</p>
+                <h1 class="header__name">Иван Иванов Иванович</h1>
+                <p class="header__role">Best Frontend Developer</p>
             </div>
         </header>
 

diff --git a/script.js → docs/script.js b/script.js → docs/script.js
diff --git a/styles.css → docs/styles.css b/styles.css → docs/styles.css