[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) [한국어](../ko/CONTRIBUTING.md) • [Nederlands](../nl/CONTRIBUTING.md) • [Polski](../pl/CONTRIBUTING.md) • [Português (BR)](../pt-BR/CONTRIBUTING.md) • Русский • [Türkçe](../tr/CONTRIBUTING.md) • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • [繁體中文](../zh-TW/CONTRIBUTING.md)
# Вклад в Roo Code Roo Code — это проект, управляемый сообществом, и мы глубоко ценим каждый вклад. Чтобы упростить совместную работу, мы работаем на основе [подхода «сначала задача»](#подход-сначала-задача), что означает, что все [запросы на слияние (PR)](#подача-запроса-на-слияние) должны быть сначала связаны с задачей на GitHub. Пожалуйста, внимательно ознакомьтесь с этим руководством. ## Оглавление - [Прежде чем вы начнете вносить свой вклад](#прежде-чем-вы-начнете-вносить-свой-вклад) - [Поиск и планирование вашего вклада](#поиск-и-планирование-вашего-вклада) - [Процесс разработки и подачи](#процесс-разработки-и-подачи) - [Юридические вопросы](#юридические-вопросы) ## Прежде чем вы начнете вносить свой вклад ### 1. Кодекс поведения Все участники должны придерживаться нашего [Кодекса поведения](./CODE_OF_CONDUCT.md). ### 2. Дорожная карта проекта Наша дорожная карта определяет направление развития проекта. Согласуйте свои вклады с этими ключевыми целями: ### Надежность прежде всего - Обеспечьте постоянную надежность редактирования различий и выполнения команд. - Уменьшите количество проблемных моментов, которые отбивают желание регулярного использования. - Гарантируйте бесперебойную работу во всех локалях и на всех платформах. - Расширьте надежную поддержку для широкого спектра поставщиков и моделей ИИ. ### Улучшенный пользовательский опыт - Оптимизируйте пользовательский интерфейс/опыт для ясности и интуитивности. - Постоянно улучшайте рабочий процесс, чтобы соответствовать высоким ожиданиям, которые разработчики предъявляют к инструментам повседневного использования. ### Лидерство в производительности агентов - Создайте комплексные оценочные тесты (evals) для измерения реальной производительности. - Сделайте так, чтобы каждый мог легко запускать и интерпретировать эти оценки. - Поставляйте улучшения, которые демонстрируют явное увеличение оценочных баллов. Упоминайте о соответствии этим областям в своих PR. ### 3. Присоединяйтесь к сообществу Roo Code - **Основной:** Присоединяйтесь к нашему [Discord](https://discord.gg/roocode) и напишите личное сообщение **Hannes Rudolph (`hrudolph`)**. - **Альтернатива:** Опытные участники mogą напрямую взаимодействовать через [Проекты GitHub](https://github.com/orgs/RooCodeInc/projects/1). ## Поиск и планирование вашего вклада ### Типы вкладов - **Исправления ошибок:** решение проблем с кодом. - **Новые функции:** добавление функциональности. - **Документация:** улучшение руководств и ясности. ### Подход «сначала задача» Все вклады начинаются с задачи на GitHub с использованием наших простых шаблонов. - **Проверьте существующие задачи**: выполните поиск в [задачах GitHub](https://github.com/RooCodeInc/Roo-Code/issues). - **Создайте задачу**, используя: - **Улучшения:** шаблон «Запрос на улучшение» (простой язык, ориентированный на пользу для пользователя). - **Ошибки:** шаблон «Отчет об ошибке» (минимальное воспроизведение + ожидаемый и фактический результат + версия). - **Хотите над этим поработать?** Напишите комментарий «Забираю» к задаче и напишите личное сообщение **Hannes Rudolph (`hrudolph`)** в [Discord](https://discord.gg/roocode), чтобы вас назначили. Назначение будет подтверждено в ветке. - **PR должны ссылаться на задачу.** Несвязанные PR могут быть закрыты. ### Решение, над чем работать - Проверьте [Проект GitHub](https://github.com/orgs/RooCodeInc/projects/1) на наличие задач «Задача [не назначена]». - Для документации посетите [Документацию Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs). ### Сообщение об ошибках - Сначала проверьте существующие отчеты. - Создайте новую ошибку, используя [шаблон «Отчет об ошибке»](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) с: - Четкими, пронумерованными шагами воспроизведения - Ожидаемым и фактическим результатом - Версией Roo Code (обязательно); поставщиком/моделью ИИ, если применимо - **Проблемы с безопасностью**: сообщайте в частном порядке через [рекомендации по безопасности](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). ## Процесс разработки и подачи ### Настройка разработки 1. **Сделайте форк и клонируйте:** ``` git clone https://github.com/ВАШЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ/Roo-Code.git ``` 2. **Установите зависимости:** ``` pnpm install ``` 3. **Отладка:** откройте в VS Code (`F5`). ### Руководство по написанию кода - Один сфокусированный PR на функцию или исправление. - Следуйте лучшим практикам ESLint и TypeScript. - Пишите четкие, описательные коммиты со ссылкой на задачи (например, `Исправляет #123`). - Предоставляйте тщательное тестирование (`npm test`). - Перед отправкой выполните rebase на последнюю ветку `main`. ### Подача запроса на слияние - Начните с **черновика PR**, если вам нужна ранняя обратная связь. - Четко опишите свои изменения, следуя шаблону запроса на слияние. - Ссылайтесь на задачу в описании/названии PR (например, «Исправляет #123»). - Предоставьте скриншоты/видео для изменений в пользовательском интерфейсе. - Укажите, необходимы ли обновления документации. ### Политика запросов на слияние - Должен ссылаться на назначенную задачу GitHub. Чтобы вас назначили: напишите комментарий «Забираю» к задаче и напишите личное сообщение **Hannes Rudolph (`hrudolph`)** в [Discord](https://discord.gg/roocode). Назначение будет подтверждено в ветке. - Несвязанные PR могут быть закрыты. - PR должны проходить тесты CI, соответствовать дорожной карте и иметь четкую документацию. ### Процесс проверки - **Ежедневная сортировка:** быстрая проверка сопровождающими. - **Еженедельный углубленный обзор:** всесторонняя оценка. - **Быстро итерируйте** на основе обратной связи. ## Юридические вопросы Внося свой вклад, вы соглашаетесь с тем, что ваши вклады будут лицензироваться по лицензии Apache 2.0, в соответствии с лицензированием Roo Code.