<div align="center">
<sub>

[English](../../CONTRIBUTING.md) • [Català](../ca/CONTRIBUTING.md) • [Deutsch](../de/CONTRIBUTING.md) • [Español](../es/CONTRIBUTING.md) • [Français](../fr/CONTRIBUTING.md) • [हिंदी](../hi/CONTRIBUTING.md) • [Bahasa Indonesia](../id/CONTRIBUTING.md) • [Italiano](../it/CONTRIBUTING.md) • [日本語](../ja/CONTRIBUTING.md)

</sub>
<sub>

[한국어](../ko/CONTRIBUTING.md) • [Nederlands](../nl/CONTRIBUTING.md) • [Polski](../pl/CONTRIBUTING.md) • [Português (BR)](../pt-BR/CONTRIBUTING.md) • <b>Русский</b> • [Türkçe](../tr/CONTRIBUTING.md) • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • [繁體中文](../zh-TW/CONTRIBUTING.md)

</sub>
</div>

# Вклад в Zoo Code

Zoo Code — это проект, управляемый сообществом, и мы глубоко ценим каждый вклад. Чтобы упростить совместную работу, мы работаем на основе [подхода «сначала задача»](#подход-сначала-задача), что означает, что все [запросы на слияние (PR)](#подача-запроса-на-слияние) должны быть сначала связаны с задачей на GitHub. Пожалуйста, внимательно ознакомьтесь с этим руководством.

## Оглавление

- [Прежде чем вы начнете вносить свой вклад](#прежде-чем-вы-начнете-вносить-свой-вклад)
- [Поиск и планирование вашего вклада](#поиск-и-планирование-вашего-вклада)
- [Процесс разработки и подачи](#процесс-разработки-и-подачи)
- [Юридические вопросы](#юридические-вопросы)

## Прежде чем вы начнете вносить свой вклад

### 1. Кодекс поведения

Все участники должны придерживаться нашего [Кодекса поведения](./CODE_OF_CONDUCT.md).

### 2. Дорожная карта проекта

Наша дорожная карта определяет направление развития проекта. Согласуйте свои вклады с этими ключевыми целями:

### Надежность прежде всего

- Обеспечьте постоянную надежность редактирования различий и выполнения команд.
- Уменьшите количество проблемных моментов, которые отбивают желание регулярного использования.
- Гарантируйте бесперебойную работу во всех локалях и на всех платформах.
- Расширьте надежную поддержку для широкого спектра поставщиков и моделей ИИ.

### Улучшенный пользовательский опыт

- Оптимизируйте пользовательский интерфейс/опыт для ясности и интуитивности.
- Постоянно улучшайте рабочий процесс, чтобы соответствовать высоким ожиданиям, которые разработчики предъявляют к инструментам повседневного использования.

### Лидерство в производительности агентов

- Создайте комплексные оценочные тесты (evals) для измерения реальной производительности.
- Сделайте так, чтобы каждый мог легко запускать и интерпретировать эти оценки.
- Поставляйте улучшения, которые демонстрируют явное увеличение оценочных баллов.

Упоминайте о соответствии этим областям в своих PR.

### 3. Присоединяйся к сообществу Zoo Code

- **Discord:** Присоединяйся к нашему [Discord](https://discord.gg/VxfP4Vx3gX).
- **Reddit:** Присоединяйся к нашему [Reddit](https://www.reddit.com/r/ZooCode/).

## Поиск и планирование вашего вклада

### Типы вкладов

- **Исправления ошибок:** решение проблем с кодом.
- **Новые функции:** добавление функциональности.
- **Документация:** улучшение руководств и ясности.

### Подход «сначала задача»

Все вклады начинаются с задачи на GitHub с использованием наших простых шаблонов.

- **Проверьте существующие задачи**: выполните поиск в [задачах GitHub](https://github.com/Zoo-Code-Org/Zoo-Code/issues).
- **Создайте задачу**, используя:
    - **Улучшения:** шаблон «Запрос на улучшение» (простой язык, ориентированный на пользу для пользователя).
    - **Ошибки:** шаблон «Отчет об ошибке» (минимальное воспроизведение + ожидаемый и фактический результат + версия).
- **Хотите над этим поработать?** Напишите комментарий «Забираю» к задаче и напишите личное сообщение основной команде в [Discord](https://discord.gg/VxfP4Vx3gX), чтобы вас назначили. Назначение будет подтверждено в ветке.
- **PR должны ссылаться на задачу.** Несвязанные PR могут быть закрыты.

### Решение, над чем работать

- Проверь [страницу GitHub Issues](https://github.com/Zoo-Code-Org/Zoo-Code/issues), чтобы найти issues.
- Для документации посетите [Документацию Zoo Code](https://github.com/Zoo-Code-Org/Zoo-Code-Docs).

### Сообщение об ошибках

- Сначала проверьте существующие отчеты.
- Создайте новую ошибку, используя [шаблон «Отчет об ошибке»](https://github.com/Zoo-Code-Org/Zoo-Code/issues/new/choose) с:
    - Четкими, пронумерованными шагами воспроизведения
    - Ожидаемым и фактическим результатом
    - Версией Zoo Code (обязательно); поставщиком/моделью ИИ, если применимо
- **Проблемы с безопасностью**: сообщайте в частном порядке через [рекомендации по безопасности](https://github.com/Zoo-Code-Org/Zoo-Code/security/advisories/new).

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

### Настройка разработки

1. **Сделайте форк и клонируйте:**

```
git clone https://github.com/YOUR_USERNAME/Zoo-Code.git
```

2. **Установите зависимости:**

```
pnpm install
```

3. **Отладка:** откройте в VS Code (`F5`).

### Руководство по написанию кода

- Один сфокусированный PR на функцию или исправление.
- Следуйте лучшим практикам ESLint и TypeScript.
- Пишите четкие, описательные коммиты со ссылкой на задачи (например, `Исправляет #123`).
- Предоставляйте тщательное тестирование (`npm test`).
- Перед отправкой выполните rebase на последнюю ветку `main`.

### Подача запроса на слияние

- Начните с **черновика PR**, если вам нужна ранняя обратная связь.
- Четко опишите свои изменения, следуя шаблону запроса на слияние.
- Ссылайтесь на задачу в описании/названии PR (например, «Исправляет #123»).
- Предоставьте скриншоты/видео для изменений в пользовательском интерфейсе.
- Укажите, необходимы ли обновления документации.

### Политика запросов на слияние

- Должен ссылаться на назначенную задачу GitHub. Чтобы вас назначили: напишите комментарий «Забираю» к задаче и напишите личное сообщение основной команде в [Discord](https://discord.gg/VxfP4Vx3gX). Назначение будет подтверждено в ветке.
- Несвязанные PR могут быть закрыты.
- PR должны проходить тесты CI, соответствовать дорожной карте и иметь четкую документацию.

### Процесс проверки

- **Ежедневная сортировка:** быстрая проверка сопровождающими.
- **Еженедельный углубленный обзор:** всесторонняя оценка.
- **Быстро итерируйте** на основе обратной связи.

## Юридические вопросы

Внося свой вклад, вы соглашаетесь с тем, что ваши вклады будут лицензироваться по лицензии Apache 2.0, в соответствии с лицензированием Zoo Code.
