# Руководство для контрибьюторов

## Как начать

1. Форкните репозиторий
2. Клонируйте ваш форк:
```bash
git clone https://github.com/your-username/send2llm.git
```
3. Создайте виртуальное окружение:
```bash
python -m venv venv
source venv/bin/activate  # Linux/Mac
# или
venv\Scripts\activate  # Windows
```
4. Установите зависимости для разработки:
```bash
pip install -r requirements-dev.txt
```

## Процесс разработки

### Ветки
- `main` - основная ветка
- `develop` - ветка разработки
- `feature/*` - ветки для новых функций
- `bugfix/*` - ветки для исправления ошибок
- `release/*` - ветки для релизов

### Коммиты
Используйте Conventional Commits:
- `feat:` - новая функциональность
- `fix:` - исправление ошибок
- `docs:` - изменения в документации
- `test:` - добавление тестов
- `refactor:` - рефакторинг кода
- `style:` - форматирование, отступы и т.д.
- `chore:` - обновление зависимостей и т.п.

### Тестирование
1. Запустите тесты:
```bash
pytest
```
2. Проверьте покрытие кода:
```bash
pytest --cov=send2llm
```

### Линтинг
```bash
# Проверка стиля кода
flake8 .

# Форматирование кода
black .

# Сортировка импортов
isort .
```

## Pull Requests

1. Убедитесь, что ваш код соответствует стандартам
2. Обновите документацию
3. Добавьте тесты
4. Создайте PR в ветку `develop`
5. Дождитесь ревью

## Документация

- Используйте docstrings в формате Google
- Обновляйте README.md при необходимости
- Добавляйте примеры кода

## Code Review

### Чеклист для ревью:
- [ ] Код соответствует стилю проекта
- [ ] Тесты проходят
- [ ] Документация обновлена
- [ ] Нет конфликтов с основной веткой
- [ ] Код оптимизирован
- [ ] Безопасность учтена

## Релизы

1. Обновите версию в `setup.py`
2. Обновите CHANGELOG.md
3. Создайте тег версии
4. Опубликуйте на PyPI

## Контакты

- Issue Tracker: GitHub Issues
- Slack канал: [ссылка]
- Email: [адрес] 