|
@@ -13,126 +13,129 @@
|
|
|
|
|
|
|
|
# Вклад в Roo Code
|
|
# Вклад в Roo Code
|
|
|
|
|
|
|
|
-Roo Code — проект, управляемый сообществом, и мы высоко ценим каждый вклад. Для упрощения сотрудничества мы работаем по принципу [Issue-First](#подход-issue-first), что означает, что все [Pull Request (PR)](#отправка-pull-request) должны сначала быть связаны с GitHub Issue. Пожалуйста, внимательно ознакомься с этим руководством.
|
|
|
|
|
|
|
+Roo Code — это проект, управляемый сообществом, и мы глубоко ценим каждый вклад. Чтобы упростить совместную работу, мы работаем на основе [подхода «сначала задача»](#подход-сначала-задача), что означает, что все [запросы на слияние (PR)](#подача-запроса-на-слияние) должны быть сначала связаны с задачей на GitHub. Пожалуйста, внимательно ознакомьтесь с этим руководством.
|
|
|
|
|
|
|
|
-## Содержание
|
|
|
|
|
|
|
+## Оглавление
|
|
|
|
|
|
|
|
-- [Перед тем как внести вклад](#перед-тем-как-внести-вклад)
|
|
|
|
|
-- [Поиск и планирование вклада](#поиск-и-планирование-вклада)
|
|
|
|
|
-- [Процесс разработки и отправки](#процесс-разработки-и-отправки)
|
|
|
|
|
-- [Юридическая информация](#юридическая-информация)
|
|
|
|
|
|
|
+- [Прежде чем вы начнете вносить свой вклад](#прежде-чем-вы-начнете-вносить-свой-вклад)
|
|
|
|
|
+- [Поиск и планирование вашего вклада](#поиск-и-планирование-вашего-вклада)
|
|
|
|
|
+- [Процесс разработки и подачи](#процесс-разработки-и-подачи)
|
|
|
|
|
+- [Юридические вопросы](#юридические-вопросы)
|
|
|
|
|
|
|
|
-## Перед тем как внести вклад
|
|
|
|
|
|
|
+## Прежде чем вы начнете вносить свой вклад
|
|
|
|
|
|
|
|
### 1. Кодекс поведения
|
|
### 1. Кодекс поведения
|
|
|
|
|
|
|
|
-Все участники должны соблюдать наш [Кодекс поведения](./CODE_OF_CONDUCT.md).
|
|
|
|
|
|
|
+Все участники должны придерживаться нашего [Кодекса поведения](./CODE_OF_CONDUCT.md).
|
|
|
|
|
|
|
|
### 2. Дорожная карта проекта
|
|
### 2. Дорожная карта проекта
|
|
|
|
|
|
|
|
-Наша дорожная карта определяет направление проекта. Согласуй свой вклад с этими ключевыми целями:
|
|
|
|
|
|
|
+Наша дорожная карта определяет направление развития проекта. Согласуйте свои вклады с этими ключевыми целями:
|
|
|
|
|
|
|
|
-### Надежность в первую очередь
|
|
|
|
|
|
|
+### Надежность прежде всего
|
|
|
|
|
|
|
|
-- Обеспечение стабильной работы редактирования различий и выполнения команд
|
|
|
|
|
-- Сокращение точек трения, препятствующих регулярному использованию
|
|
|
|
|
-- Гарантия бесперебойной работы на всех языках и платформах
|
|
|
|
|
-- Расширение надежной поддержки для широкого спектра ИИ-провайдеров и моделей
|
|
|
|
|
|
|
+- Обеспечьте постоянную надежность редактирования различий и выполнения команд.
|
|
|
|
|
+- Уменьшите количество проблемных моментов, которые отбивают желание регулярного использования.
|
|
|
|
|
+- Гарантируйте бесперебойную работу во всех локалях и на всех платформах.
|
|
|
|
|
+- Расширьте надежную поддержку для широкого спектра поставщиков и моделей ИИ.
|
|
|
|
|
|
|
|
### Улучшенный пользовательский опыт
|
|
### Улучшенный пользовательский опыт
|
|
|
|
|
|
|
|
-- Упрощение пользовательского интерфейса для большей ясности и интуитивности
|
|
|
|
|
-- Постоянное совершенствование рабочего процесса для соответствия высоким ожиданиям разработчиков
|
|
|
|
|
|
|
+- Оптимизируйте пользовательский интерфейс/опыт для ясности и интуитивности.
|
|
|
|
|
+- Постоянно улучшайте рабочий процесс, чтобы соответствовать высоким ожиданиям, которые разработчики предъявляют к инструментам повседневного использования.
|
|
|
|
|
|
|
|
### Лидерство в производительности агентов
|
|
### Лидерство в производительности агентов
|
|
|
|
|
|
|
|
-- Создание комплексных показателей оценки (evals) для измерения реальной продуктивности
|
|
|
|
|
-- Упрощение запуска и интерпретации этих оценок для всех пользователей
|
|
|
|
|
-- Внедрение улучшений, демонстрирующих явное повышение оценочных показателей
|
|
|
|
|
|
|
+- Создайте комплексные оценочные тесты (evals) для измерения реальной производительности.
|
|
|
|
|
+- Сделайте так, чтобы каждый мог легко запускать и интерпретировать эти оценки.
|
|
|
|
|
+- Поставляйте улучшения, которые демонстрируют явное увеличение оценочных баллов.
|
|
|
|
|
|
|
|
-Упоминай связь с этими направлениями в своих PR.
|
|
|
|
|
|
|
+Упоминайте о соответствии этим областям в своих PR.
|
|
|
|
|
|
|
|
-### 3. Присоединяйся к сообществу Roo Code
|
|
|
|
|
|
|
+### 3. Присоединяйтесь к сообществу Roo Code
|
|
|
|
|
|
|
|
-- **Основной способ:** Присоединись к нашему [Discord](https://discord.gg/roocode) и отправь личное сообщение **Hannes Rudolph (`hrudolph`)**.
|
|
|
|
|
-- **Альтернатива:** Опытные участники могут взаимодействовать напрямую через [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1).
|
|
|
|
|
|
|
+- **Основной:** Присоединяйтесь к нашему [Discord](https://discord.gg/roocode) и напишите личное сообщение **Hannes Rudolph (`hrudolph`)**.
|
|
|
|
|
+- **Альтернатива:** Опытные участники mogą напрямую взаимодействовать через [Проекты GitHub](https://github.com/orgs/RooCodeInc/projects/1).
|
|
|
|
|
|
|
|
-## Поиск и планирование вклада
|
|
|
|
|
|
|
+## Поиск и планирование вашего вклада
|
|
|
|
|
|
|
|
-### Виды вклада
|
|
|
|
|
|
|
+### Типы вкладов
|
|
|
|
|
|
|
|
-- **Исправление ошибок:** Решение проблем в коде.
|
|
|
|
|
-- **Новые функции:** Добавление функциональности.
|
|
|
|
|
-- **Документация:** Улучшение руководств и ясности.
|
|
|
|
|
|
|
+- **Исправления ошибок:** решение проблем с кодом.
|
|
|
|
|
+- **Новые функции:** добавление функциональности.
|
|
|
|
|
+- **Документация:** улучшение руководств и ясности.
|
|
|
|
|
|
|
|
-### Подход Issue-First
|
|
|
|
|
|
|
+### Подход «сначала задача»
|
|
|
|
|
|
|
|
-Весь вклад должен начинаться с GitHub Issue.
|
|
|
|
|
|
|
+Все вклады начинаются с задачи на GitHub с использованием наших простых шаблонов.
|
|
|
|
|
|
|
|
-- **Проверь существующие issues:** Поищи в [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues).
|
|
|
|
|
-- **Создай issue:** Используй подходящие шаблоны:
|
|
|
|
|
- - **Баги:** Шаблон "Bug Report".
|
|
|
|
|
- - **Функции:** Шаблон "Detailed Feature Proposal". Требуется одобрение перед началом.
|
|
|
|
|
-- **Заяви issue:** Оставь комментарий и дождись официального назначения.
|
|
|
|
|
-
|
|
|
|
|
-**PR без одобренных issue могут быть закрыты.**
|
|
|
|
|
|
|
+- **Проверьте существующие задачи**: выполните поиск в [задачах 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) на наличие незанятых "Good First Issues".
|
|
|
|
|
-- Для документации посети [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs).
|
|
|
|
|
|
|
+- Проверьте [Проект GitHub](https://github.com/orgs/RooCodeInc/projects/1) на наличие задач «Задача [не назначена]».
|
|
|
|
|
+- Для документации посетите [Документацию Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs).
|
|
|
|
|
|
|
|
### Сообщение об ошибках
|
|
### Сообщение об ошибках
|
|
|
|
|
|
|
|
-- Сначала проверь существующие сообщения.
|
|
|
|
|
-- Создай новые сообщения об ошибках, используя [шаблон "Bug Report"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose).
|
|
|
|
|
-- **Уязвимости безопасности:** Сообщай приватно через [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new).
|
|
|
|
|
|
|
+- Сначала проверьте существующие отчеты.
|
|
|
|
|
+- Создайте новую ошибку, используя [шаблон «Отчет об ошибке»](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) с:
|
|
|
|
|
+ - Четкими, пронумерованными шагами воспроизведения
|
|
|
|
|
+ - Ожидаемым и фактическим результатом
|
|
|
|
|
+ - Версией Roo Code (обязательно); поставщиком/моделью ИИ, если применимо
|
|
|
|
|
+- **Проблемы с безопасностью**: сообщайте в частном порядке через [рекомендации по безопасности](https://github.com/RooCodeInc/Roo-Code/security/advisories/new).
|
|
|
|
|
|
|
|
-## Процесс разработки и отправки
|
|
|
|
|
|
|
+## Процесс разработки и подачи
|
|
|
|
|
|
|
|
-### Настройка среды разработки
|
|
|
|
|
|
|
+### Настройка разработки
|
|
|
|
|
|
|
|
-1. **Fork & Clone:**
|
|
|
|
|
|
|
+1. **Сделайте форк и клонируйте:**
|
|
|
|
|
|
|
|
```
|
|
```
|
|
|
-git clone https://github.com/ТВОЙ_ПОЛЬЗОВАТЕЛЬ/Roo-Code.git
|
|
|
|
|
|
|
+git clone https://github.com/ВАШЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ/Roo-Code.git
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
-2. **Установка зависимостей:**
|
|
|
|
|
|
|
+2. **Установите зависимости:**
|
|
|
|
|
|
|
|
```
|
|
```
|
|
|
-npm run install:all
|
|
|
|
|
|
|
+pnpm install
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
-3. **Отладка:** Открой в VS Code (`F5`).
|
|
|
|
|
|
|
+3. **Отладка:** откройте в VS Code (`F5`).
|
|
|
|
|
|
|
|
### Руководство по написанию кода
|
|
### Руководство по написанию кода
|
|
|
|
|
|
|
|
- Один сфокусированный PR на функцию или исправление.
|
|
- Один сфокусированный PR на функцию или исправление.
|
|
|
-- Следуй лучшим практикам ESLint и TypeScript.
|
|
|
|
|
-- Пиши ясные, описательные сообщения коммитов с ссылками на issues (например, `Fixes #123`).
|
|
|
|
|
-- Обеспечь тщательное тестирование (`npm test`).
|
|
|
|
|
-- Перебазируй на последнюю ветку `main` перед отправкой.
|
|
|
|
|
|
|
+- Следуйте лучшим практикам ESLint и TypeScript.
|
|
|
|
|
+- Пишите четкие, описательные коммиты со ссылкой на задачи (например, `Исправляет #123`).
|
|
|
|
|
+- Предоставляйте тщательное тестирование (`npm test`).
|
|
|
|
|
+- Перед отправкой выполните rebase на последнюю ветку `main`.
|
|
|
|
|
|
|
|
-### Отправка Pull Request
|
|
|
|
|
|
|
+### Подача запроса на слияние
|
|
|
|
|
|
|
|
-- Начни с **черновика PR**, если ищешь ранний фидбек.
|
|
|
|
|
-- Четко опиши свои изменения, следуя шаблону Pull Request.
|
|
|
|
|
-- Предоставь скриншоты/видео для изменений UI.
|
|
|
|
|
-- Укажи, нужны ли обновления документации.
|
|
|
|
|
|
|
+- Начните с **черновика PR**, если вам нужна ранняя обратная связь.
|
|
|
|
|
+- Четко опишите свои изменения, следуя шаблону запроса на слияние.
|
|
|
|
|
+- Ссылайтесь на задачу в описании/названии PR (например, «Исправляет #123»).
|
|
|
|
|
+- Предоставьте скриншоты/видео для изменений в пользовательском интерфейсе.
|
|
|
|
|
+- Укажите, необходимы ли обновления документации.
|
|
|
|
|
|
|
|
-### Политика Pull Request
|
|
|
|
|
|
|
+### Политика запросов на слияние
|
|
|
|
|
|
|
|
-- Должен ссылаться на предварительно одобренные и назначенные issue.
|
|
|
|
|
-- PR, не соответствующие политике, могут быть закрыты.
|
|
|
|
|
-- PR должны проходить CI-тесты, соответствовать дорожной карте и иметь четкую документацию.
|
|
|
|
|
|
|
+- Должен ссылаться на назначенную задачу GitHub. Чтобы вас назначили: напишите комментарий «Забираю» к задаче и напишите личное сообщение **Hannes Rudolph (`hrudolph`)** в [Discord](https://discord.gg/roocode). Назначение будет подтверждено в ветке.
|
|
|
|
|
+- Несвязанные PR могут быть закрыты.
|
|
|
|
|
+- PR должны проходить тесты CI, соответствовать дорожной карте и иметь четкую документацию.
|
|
|
|
|
|
|
|
### Процесс проверки
|
|
### Процесс проверки
|
|
|
|
|
|
|
|
-- **Ежедневный отбор:** Быстрые проверки мейнтейнерами.
|
|
|
|
|
-- **Еженедельный глубокий обзор:** Комплексная оценка.
|
|
|
|
|
-- **Быстро итерируй** на основе полученного фидбека.
|
|
|
|
|
|
|
+- **Ежедневная сортировка:** быстрая проверка сопровождающими.
|
|
|
|
|
+- **Еженедельный углубленный обзор:** всесторонняя оценка.
|
|
|
|
|
+- **Быстро итерируйте** на основе обратной связи.
|
|
|
|
|
|
|
|
-## Юридическая информация
|
|
|
|
|
|
|
+## Юридические вопросы
|
|
|
|
|
|
|
|
-Отправляя pull request, ты соглашаешься, что твой вклад будет лицензирован под лицензией Apache 2.0, в соответствии с лицензией Roo Code.
|
|
|
|
|
|
|
+Внося свой вклад, вы соглашаетесь с тем, что ваши вклады будут лицензироваться по лицензии Apache 2.0, в соответствии с лицензированием Roo Code.
|