update

Author: s00d

DEPLOYMENT.md

@@ -5,10 +5,13 @@
 ### Как это работает
 
 1. **Создается git тег** с версией (например, `v2.1.0`)
-2. **GitHub Actions автоматически запускается** при пуше тега
-3. **Пакет собирается** с помощью modern Python tools
-4. **Загружается в PyPI** с использованием API токена
-5. **Создается GitHub Release** с собранными файлами
+2. **Тег пушится в GitHub** (это обязательный шаг!)
+3. **GitHub Actions автоматически запускается** при пуше тега (workflow настроен на `tags: - 'v*'`)
+4. **Пакет собирается** с помощью modern Python tools
+5. **Загружается в PyPI** с использованием API токена
+6. **Создается GitHub Release** с собранными файлами
+
+**Ключевой момент**: Workflow запускается ТОЛЬКО при создании новых тегов, не при обычных коммитах в main ветку.
 
 ### 📋 Предварительная настройка (только один раз)
 
@@ -37,6 +40,8 @@
 
 ### 🔄 Процесс публикации новой версии
 
+**Полный пример процесса для версии 2.1.0:**
+
 #### Шаг 1: Обновить версию
 
 Обновите версию в `pyproject.toml`:
@@ -75,14 +80,28 @@ git push origin main
 
 #### Шаг 4: Создать тег и запустить публикацию
 
+**Важно**: Для каждой новой версии необходимо создавать новый git тег, так как GitHub Actions workflow запускается только при создании тегов.
+
 ```bash
 ./deploy.sh
 ```
 
 Этот скрипт:
-- Создает git тег с версией
+- Создает git тег с версией (например, `v2.1.0`)
 - Пушит тег в GitHub
-- Запускает автоматическую публикацию
+- Запускает автоматическую публикацию через GitHub Actions
+
+**Альтернативно, можно создать тег вручную:**
+
+```bash
+# Создать тег локально
+git tag v2.1.0
+
+# Запушить тег в GitHub
+git push origin v2.1.0
+```
+
+После пуша тега GitHub Actions автоматически запустит процесс публикации.
 
 ### 📊 Мониторинг процесса
 
@@ -109,12 +128,16 @@ git push origin main
 - 🎯 **Контроль**: Можно настроить правила для environment
 - 🏷️ **Теги**: Четкая связь между git тегами и версиями PyPI
 
+**⚠️ Важное напоминание**: Каждая новая версия требует создания нового git тега. Без тега workflow не запустится!
+
 ### 🚨 Troubleshooting
 
 #### Если workflow не запускается:
-1. Проверьте, что тег создан в правильном формате (`v*`)
-2. Убедитесь, что тег запушен в GitHub
-3. Проверьте настройки в **Settings** → **Actions** → **General**
+1. **Проверьте, что тег создан в правильном формате** (`v*` - например, `v2.1.0`)
+2. **Убедитесь, что тег запушен в GitHub** - это критически важно!
+3. **Проверьте, что тег создан для правильной версии** в `pyproject.toml`
+4. Проверьте настройки в **Settings** → **Actions** → **General**
+5. **Помните**: workflow запускается только при создании новых тегов, не при коммитах
 
 #### Если публикация в PyPI не удалась:
 1. Проверьте логи в GitHub Actions