diff --git a/README.md b/README.md
index 2a5f4ee..5994167 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,27 @@
-HELLO WORLD! I MANAGED THIS SHIT!!!
+# returntozer0.ru-blog
+
+Репозиторий содержит исходный код, настройки и контент личного блога [returntozer0.ru](https://returntozer0.ru).
+
+## О проекте
+
+Сайт построен на генераторе статических сайтов **Hugo** с использованием темы **PaperMod**. Здесь хранятся:
+- Настройки конфигурации сайта.
+- Кастомные шаблоны и частичные макеты (layouts/partials).
+- Исходники всех статей в формате Markdown.
+- Резервная копия контента на случай технических сбоев.
+
+## Технологический стек
+
+- **Framework:** Hugo
+- **Theme:** PaperMod
+- **Deployment:** Docker & Docker Compose
+- **Web Server:** Nginx (внутри контейнера)
+
+## Структура репозитория
+
+- `/content` — исходные файлы статей и страниц.
+- `/themes` — подключенные темы (через git submodules).
+- `/layouts` — переопределенные шаблоны Hugo.
+- `config.toml` — основной файл конфигурации сайта.
+- `Dockerfile` & `docker-compose.yml` — конфигурация для контейнеризации и деплоя.
+