From d2643d4df0f4f29fe2b4c4bc84c64d5439f18b3e Mon Sep 17 00:00:00 2001 From: Hannes Rudolph Date: Mon, 15 Sep 2025 22:21:54 -0600 Subject: [PATCH] docs: move README overhaul changes onto branch based off main --- .github/ISSUE_TEMPLATE/bug_report.yml | 106 ++++++----- .github/ISSUE_TEMPLATE/feature_request.yml | 202 +++++---------------- CONTRIBUTING.md | 25 +-- locales/ca/CONTRIBUTING.md | 135 +++++++------- locales/de/CONTRIBUTING.md | 127 ++++++------- locales/es/CONTRIBUTING.md | 151 +++++++-------- locales/fr/CONTRIBUTING.md | 113 ++++++------ locales/hi/CONTRIBUTING.md | 135 +++++++------- locales/id/CONTRIBUTING.md | 109 +++++------ locales/it/CONTRIBUTING.md | 109 +++++------ locales/ja/CONTRIBUTING.md | 135 +++++++------- locales/ko/CONTRIBUTING.md | 135 +++++++------- locales/nl/CONTRIBUTING.md | 117 ++++++------ locales/pl/CONTRIBUTING.md | 135 +++++++------- locales/pt-BR/CONTRIBUTING.md | 141 +++++++------- locales/ru/CONTRIBUTING.md | 137 +++++++------- locales/tr/CONTRIBUTING.md | 137 +++++++------- locales/vi/CONTRIBUTING.md | 139 +++++++------- locales/zh-CN/CONTRIBUTING.md | 141 +++++++------- locales/zh-TW/CONTRIBUTING.md | 141 +++++++------- 20 files changed, 1267 insertions(+), 1303 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index c659eb80eb6..9e22303a350 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -1,12 +1,66 @@ name: Bug Report -description: Clearly report a bug with detailed repro steps +description: Report a broken behavior in plain language with a minimal reproduction labels: ["bug"] +title: "[BUG] " body: - type: markdown attributes: value: | - **Thanks for your report!** Please check existing issues first: - 👉 https://github.com/RooCodeInc/Roo-Code/issues + Thank you for your report! Please search existing issues first: + https://github.com/RooCodeInc/Roo-Code/issues + + - type: textarea + id: problem + attributes: + label: Problem (one or two sentences) + description: Describe what went wrong in plain language. + placeholder: 'Example: "Expected the task to start, but nothing happened and no message appeared."' + validations: + required: true + + - type: textarea + id: context + attributes: + label: Context (who is affected and when) + description: Who sees this and in what situation? Keep it non-technical. + placeholder: 'Example: "Happens to new users when starting a run from the New Run page with dark theme enabled."' + validations: + required: true + + - type: textarea + id: steps + attributes: + label: Reproduction steps + description: Provide clear, numbered steps so we can reproduce. + placeholder: | + 1) Environment/setup (OS, extension version, relevant settings) + 2) Exact actions (clicks, inputs, commands) + 3) What you observed after each step + validations: + required: true + + - type: input + id: expected + attributes: + label: Expected result + placeholder: e.g., "The task starts and shows progress." + validations: + required: true + + - type: input + id: actual + attributes: + label: Actual result + placeholder: e.g., "The button appears disabled and no progress is shown." + validations: + required: true + + - type: textarea + id: variations + attributes: + label: Variations tried (optional) + description: Different browsers, devices, providers, or settings you tried. + placeholder: e.g., "Tried Chrome/Firefox, disabling dark theme, switching providers." - type: input id: version @@ -19,7 +73,7 @@ body: - type: dropdown id: provider attributes: - label: API Provider + label: API Provider (optional) options: - Anthropic - AWS Bedrock @@ -45,57 +99,23 @@ body: - VS Code Language Model API - xAI (Grok) - Not Applicable / Other - validations: - required: true - type: input id: model attributes: - label: Model Used + label: Model Used (optional) description: Exact model name (e.g., Claude 3.7 Sonnet). Use N/A if irrelevant. - validations: - required: true - type: textarea id: roo-code-tasks attributes: - label: Roo Code Task Links (Optional) - description: | - If you have any publicly shared task links that demonstrate the issue, please paste them here. - This helps maintainers understand the context. - Example: https://app.roocode.com/share/task-id + label: Roo Code Task Links (optional) + description: If you have any publicly shared Roo Code task links that demonstrate the issue, paste them here. placeholder: Paste your Roo Code share links here, one per line - - type: textarea - id: steps - attributes: - label: 🔁 Steps to Reproduce - description: | - Help us see what you saw. Give clear, numbered steps: - - 1. Setup (OS, extension version, settings) - 2. Exact actions (clicks, input, files, commands) - 3. What happened after each step - - Think like you're writing a recipe. Without this, we can't reproduce the issue. - validations: - required: true - - - type: textarea - id: what-happened - attributes: - label: 💥 Outcome Summary - description: | - Recap what went wrong in one or two lines. - - Example: "Expected code to run, but got an empty response and no error." - placeholder: Expected ___, but got ___. - validations: - required: true - - type: textarea id: logs attributes: - label: 📄 Relevant Logs or Errors (Optional) - description: Paste API logs, terminal output, or errors here. Use triple backticks (```) for code formatting. + label: Relevant logs or errors (optional) + description: Paste relevant output or errors. Use triple backticks (```) for formatting. render: shell diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index 4863f9ffa61..7e140ec08cc 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -1,71 +1,47 @@ -name: Detailed Feature Proposal -description: Report a specific problem that needs solving in Roo Code -labels: ["proposal", "enhancement"] +name: Enhancement Request +description: Propose an improvement in plain language focused on user benefit +labels: ["enhancement"] +title: "[ENHANCEMENT] " body: - type: markdown attributes: value: | - **Thank you for submitting a feature request for Roo Code!** - - This template helps you describe problems that need solving. Focus on the problem - the Roo team will work to design solutions unless you want to contribute the implementation yourself. - - **Quality over speed:** We prefer detailed, clear problem descriptions over quick ones. Vague requests often get closed or require multiple rounds of clarification, which wastes everyone's time. - - **Before submitting:** - - Search existing [Issues](https://github.com/RooCodeInc/Roo-Code/issues) and [Discussions](https://github.com/RooCodeInc/Roo-Code/discussions) to avoid duplicates - - For general ideas, use [GitHub Discussions](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) instead of this template. + Thank you for helping improve Roo Code! + Please focus on the problem and the desired behavior in plain language. - - type: markdown + - type: textarea + id: problem attributes: - value: | - ## ❌ Common mistakes that lead to request rejection: - - **Vague problem descriptions:** "UI is bad" -> Should be: "Submit button is invisible on dark theme" - - **Missing user impact:** "This would be cool" -> Should explain who benefits and how - - **No specific context:** Describe exactly when and how the problem occurs - + label: Problem (one or two sentences) + description: What problem are users facing? + placeholder: e.g., "Users often click Copy Run by mistake and duplicate runs unintentionally." + validations: + required: true - type: textarea - id: problem-description + id: context attributes: - label: What specific problem does this solve? - description: | - **Be concrete and detailed.** Explain the problem from a user's perspective. - - ✅ **Good examples (specific, clear impact):** - - "When running large tasks, users wait 5+ minutes because tasks execute sequentially instead of in parallel, blocking productivity" - - "AI can only read one file per request, forcing users to make multiple requests for multi-file projects, increasing wait time from 30s to 5+ minutes" - - "Dark theme users can't see the submit button because it uses white text on light grey background" - - ❌ **Poor examples (vague, unclear impact):** - - "The UI looks weird" -> What specifically looks weird? On which screen? What's the impact? - - "System prompt is not good" -> What's wrong with it? What behaviour does it cause? What should it do instead? - - "Performance could be better" -> Where? How slow is it currently? What's the user impact? - - **Your problem description should answer:** - - Who is affected? (all users, specific user types, etc.) - - When does this happen? (specific scenarios/steps) - - What's the current behaviour vs expected behaviour? - - What's the impact? (time wasted, errors caused, etc.) - placeholder: Be specific about the problem, who it affects, and the impact. Avoid generic statements like "it's slow" or "it's confusing." + label: Context (who is affected and when) + description: Who encounters this and in what situation? + placeholder: e.g., "Happens when browsing the Runs list; most visible for new users." validations: required: true - - type: textarea - id: additional-context + id: desired attributes: - label: Additional context (optional) - description: Mockups, screenshots, links, user quotes, or other relevant information that supports your proposal. + label: Desired behavior (conceptual, not technical) + description: Describe what should happen in simple terms. + placeholder: e.g., "Ask for confirmation before copying a run." + validations: + required: true - type: textarea - id: roo-code-tasks + id: constraints attributes: - label: Roo Code Task Links (Optional) - description: | - If you used Roo Code to explore this feature request or develop solutions, share the public task links here. - This helps maintainers understand the context and any exploration you've done. - Example: https://app.roocode.com/share/task-id - placeholder: Paste your Roo Code share links here, one per line + label: Constraints / preferences (optional) + description: Any considerations like performance, accessibility, or UX expectations. + placeholder: e.g., "Keep it quick and unobtrusive; keyboard accessible." - type: checkboxes id: checklist @@ -74,128 +50,42 @@ body: options: - label: I've searched existing Issues and Discussions for duplicates required: true - - label: This describes a specific problem with clear impact and context + - label: This describes a specific problem with clear context and impact required: true + - type: textarea + id: roo-code-tasks + attributes: + label: Roo Code Task Links (optional) + description: If you explored this with Roo Code, share public task links for context. + placeholder: Paste your Roo Code share links here, one per line + - type: markdown attributes: value: | --- - - ## 🛠️ **Optional: Contributing & Technical Analysis** - - **🎯 Just reporting a problem?** You can click "Submit new issue" right now! The sections below are only needed if you want to contribute a solution via pull request. - - **⚠️ Only continue if you want to:** - - Propose a specific solution design - - Implement the feature yourself via pull request - - Provide technical analysis to help with implementation - - **For contributors who continue:** - - A maintainer (especially @hannesrudolph) will review this proposal. **Do not start implementation until approved and assigned.** We're a small team with limited resources, so every code addition needs careful consideration. We're always happy to receive clear, actionable proposals though! - - Join [Discord](https://discord.gg/roocode) and DM **Hannes Rudolph** (`hrudolph`) for guidance on implementation - - Check our [Roadmap](https://github.com/orgs/RooCodeInc/projects/1/views/1?query=sort%3Aupdated-desc+is%3Aopen&filterQuery=is%3Aissue%2Copen%2Cclosed+label%3A%22feature+request%22+status%3A%22Issue+%5BUnassigned%5D%22%2C%22Issue+%5BIn+Progress%5D%22) to see open feature requests ready to be implemented or currently being worked on - - - type: checkboxes - id: willingness-to-contribute - attributes: - label: Interested in implementing this? - description: | - **Important:** If you check "Yes" below, the technical sections become REQUIRED. - We need detailed technical analysis from contributors to ensure quality implementation. - options: - - label: Yes, I'd like to help implement this feature - required: false - - - type: checkboxes - id: implementation-approval - attributes: - label: Implementation requirements - options: - - label: I understand this needs approval before implementation begins - required: false - - - type: textarea - id: proposed-solution - attributes: - label: How should this be solved? (REQUIRED if contributing, optional otherwise) - description: | - **If you want to implement this feature, this section is REQUIRED.** - - **Describe your solution in detail.** Explain not just what to build, but how it should work. - - ✅ **Good examples:** - - "Add parallel task execution: Allow up to 3 tasks to run simultaneously with a queue system for additional tasks. Show progress for each active task in the UI." - - "Enable multi-file AI processing: Modify the request handler to accept multiple files in a single request and process them together, reducing round trips." - - "Fix button contrast: Change submit button to use primary colour on dark theme (white text on blue background) instead of current grey." - - ❌ **Poor examples:** - - "Make it faster" -> How? What specific changes? - - "Improve the UI" -> Which part? What specific improvements? - - "Fix the prompt" -> What should the new prompt do differently? - - **Your solution should explain:** - - What exactly will change? - - How will users interact with it? - - What will the new behaviour look like? - placeholder: Describe the specific changes and how they will work. Include user interaction details if relevant. + Optional (for contributors): You can stop here if you're just proposing the improvement. - type: textarea id: acceptance-criteria attributes: - label: How will we know it works? (Acceptance Criteria - REQUIRED if contributing, optional otherwise) - description: | - **If you want to implement this feature, this section is REQUIRED.** - - **This is crucial - don't skip it.** Define what "working" looks like with specific, testable criteria. - - **Format suggestion:** - ``` - Given [context/situation] + label: Acceptance criteria (optional) + description: Define what “working” looks like with specific, testable outcomes. + placeholder: | + Given [context] When [user action] Then [expected result] And [additional expectations] But [what should NOT happen] - ``` - - **Example:** - ``` - Given I have 5 large tasks to run - When I start all of them - Then they execute in parallel (max 3 at once, can be configured) - And I see progress for each active task - And queued tasks show "waiting" status - But the UI doesn't freeze or become unresponsive - ``` - placeholder: | - Define specific, testable criteria. What should users be able to do? What should happen? What should NOT happen? - Use the Given/When/Then format above or your own clear structure. - type: textarea - id: technical-considerations + id: proposed-solution attributes: - label: Technical considerations (REQUIRED if contributing, optional otherwise) - description: | - **If you want to implement this feature, this section is REQUIRED.** - - Share technical insights that could help planning: - - Implementation approach or architecture changes - - Performance implications - - Compatibility concerns - - Systems that might be affected - - Potential blockers you can foresee - placeholder: e.g., "Will need to refactor task manager", "Could impact memory usage on large files", "Requires a large portion of code to be rewritten" + label: Proposed approach (optional) + description: If you have an idea, describe it briefly in plain language. - type: textarea - id: trade-offs-and-risks + id: risks attributes: - label: Trade-offs and risks (REQUIRED if contributing, optional otherwise) - description: | - **If you want to implement this feature, this section is REQUIRED.** - - What could go wrong or what alternatives did you consider? - - Alternative approaches and why you chose this one - - Potential negative impacts (performance, UX, etc.) - - Breaking changes or migration concerns - - Edge cases that need careful handling - placeholder: 'e.g., "Alternative: use library X but it is 500KB larger", "Risk: might slow older devices", "Breaking: changes API response format"' + label: Trade-offs / risks (optional) + description: Potential downsides or alternatives considered. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c23c424f414..869b59a16da 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -67,25 +67,27 @@ Mention alignment with these areas in your PRs. ### Issue-First Approach -All contributions must begin with a GitHub Issue. +All contributions start with a GitHub Issue using our skinny templates. - **Check existing issues**: Search [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Create an issue**: Use appropriate templates: - - **Bugs:** "Bug Report" template. - - **Features:** "Detailed Feature Proposal" template. Approval required before starting. -- **Claim issues**: Comment and await official assignment. - -**PRs without approved issues may be closed.** +- **Create an issue** using: + - **Enhancements:** "Enhancement Request" template (plain language focused on user benefit). + - **Bugs:** "Bug Report" template (minimal repro + expected vs actual + version). +- **Want to work on it?** Comment "Claiming" on the issue and DM **Hannes Rudolph (`hrudolph`)** on [Discord](https://discord.gg/roocode) to get assigned. Assignment will be confirmed in the thread. +- **PRs must link to the issue.** Unlinked PRs may be closed. ### Deciding What to Work On -- Check the [GitHub Project](https://github.com/orgs/RooCodeInc/projects/1) for unassigned "Good First Issues." +- Check the [GitHub Project](https://github.com/orgs/RooCodeInc/projects/1) for "Issue [Unassigned]" issues. - For docs, visit [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). ### Reporting Bugs - Check for existing reports first. -- Create new bugs using the ["Bug Report" template](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). +- Create a new bug using the ["Bug Report" template](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) with: + - Clear, numbered reproduction steps + - Expected vs actual result + - Roo Code version (required); API provider/model if relevant - **Security issues**: Report privately via [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). ## Development & Submission Process @@ -118,13 +120,14 @@ pnpm install - Begin as a **Draft PR** if seeking early feedback. - Clearly describe your changes following the Pull Request Template. +- Link the issue in the PR description/title (e.g., "Fixes #123"). - Provide screenshots/videos for UI changes. - Indicate if documentation updates are necessary. ### Pull Request Policy -- Must reference pre-approved, assigned issues. -- PRs without adherence to the policy may be closed. +- Must reference an assigned GitHub Issue. To get assigned: comment "Claiming" on the issue and DM **Hannes Rudolph (`hrudolph`)** on [Discord](https://discord.gg/roocode). Assignment will be confirmed in the thread. +- Unlinked PRs may be closed. - PRs should pass CI tests, align with the roadmap, and have clear documentation. ### Review Process diff --git a/locales/ca/CONTRIBUTING.md b/locales/ca/CONTRIBUTING.md index 6c6459949dc..1a3bd0c1b70 100644 --- a/locales/ca/CONTRIBUTING.md +++ b/locales/ca/CONTRIBUTING.md @@ -13,126 +13,129 @@ # Contribuir a Roo Code -Roo Code és un projecte impulsat per la comunitat i valorem molt cada contribució. Per simplificar la col·laboració, treballem amb un enfoc [Issue-First](#enfoc-issue-first), que significa que tots els [Pull Requests (PRs)](#enviar-un-pull-request) han d'estar primer vinculats a una Issue de GitHub. Si us plau, llegeix aquesta guia amb atenció. +Roo Code és un projecte impulsat per la comunitat i valorem profundament cada contribució. Per agilitzar la col·laboració, operem sobre una base de [primer la incidència](#enfocament-de-primera-incidència), la qual cosa significa que totes les [sol·licituds d'extracció (PR)](#enviament-duna-sollicitud-dextracció) primer han d'estar enllaçades a una incidència de GitHub. Si us plau, reviseu aquesta guia amb atenció. ## Taula de continguts - [Abans de contribuir](#abans-de-contribuir) -- [Trobar i planificar la teva contribució](#trobar-i-planificar-la-teva-contribució) -- [Procés de desenvolupament i enviament](#procés-de-desenvolupament-i-enviament) +- [Trobar i planificar la vostra contribució](#trobar-i-planificar-la-vostra-contribució) +- [Procés de desenvolupament i submissió](#procés-de-desenvolupament-i-submissió) - [Legal](#legal) ## Abans de contribuir -### 1. Codi de conducta +### 1. Codi de Conducta -Tots els col·laboradors han de complir el nostre [Codi de conducta](./CODE_OF_CONDUCT.md). +Tots els col·laboradors han de complir el nostre [Codi de Conducta](./CODE_OF_CONDUCT.md). -### 2. Fulla de ruta del projecte +### 2. Full de ruta del projecte -La nostra fulla de ruta orienta la direcció del projecte. Alinea les teves contribucions amb aquests objectius clau: +El nostre full de ruta guia la direcció del projecte. Alineeu les vostres contribucions amb aquests objectius clau: -### Fiabilitat primer +### La fiabilitat primer -- Garantir que l'edició de diferències i l'execució de comandes siguin consistentment fiables -- Reduir els punts de fricció que desanimen l'ús regular -- Garantir un funcionament fluid en tots els idiomes i plataformes -- Ampliar el suport robust per a una àmplia varietat de proveïdors i models d'IA +- Assegureu-vos que l'edició de diferències i l'execució d'ordres siguin fiables de manera consistent. +- Reduïu els punts de fricció que desincentiven l'ús habitual. +- Garantiu un funcionament fluid en tots els llocs i plataformes. +- Amplieu el suport robust per a una àmplia varietat de proveïdors i models d'IA. ### Experiència d'usuari millorada -- Simplificar la interfície d'usuari per a més claredat i intuïció -- Millorar contínuament el flux de treball per satisfer les altes expectatives dels desenvolupadors +- Agilitzeu la interfície d'usuari/experiència d'usuari per a més claredat i intuïtivitat. +- Milloreu contínuament el flux de treball per satisfer les altes expectatives que els desenvolupadors tenen de les eines d'ús diari. -### Lideratge en rendiment dels agents +### Liderant en rendiment d'agents -- Establir punts de referència d'avaluació (evals) complets per mesurar la productivitat real -- Facilitar que tothom pugui executar i interpretar aquestes avaluacions fàcilment -- Proporcionar millores que demostrin increments clars en les puntuacions d'avaluació +- Establir punts de referència d'avaluació complets (evals) per mesurar la productivitat del món real. +- Feu que sigui fàcil per a tothom executar i interpretar aquestes avaluacions. +- Envieu millores que demostrin augments clars en les puntuacions d'avaluació. -Esmenta la relació amb aquestes àrees als teus PRs. +Mencioneu l'alineació amb aquestes àrees a les vostres sol·licituds d'extracció. -### 3. Uneix-te a la comunitat Roo Code +### 3. Uniu-vos a la comunitat de Roo Code -- **Principal:** Uneix-te al nostre [Discord](https://discord.gg/roocode) i envia un DM a **Hannes Rudolph (`hrudolph`)**. -- **Alternativa:** Els col·laboradors experimentats poden participar directament via [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). +- **Principal:** Uniu-vos al nostre [Discord](https://discord.gg/roocode) i envieu un missatge directe a **Hannes Rudolph (`hrudolph`)**. +- **Alternativa:** Els col·laboradors experimentats poden participar directament a través de [Projectes de GitHub](https://github.com/orgs/RooCodeInc/projects/1). -## Trobar i planificar la teva contribució +## Trobar i planificar la vostra contribució ### Tipus de contribucions -- **Correcció d'errors:** Solucionar problemes en el codi. -- **Noves funcionalitats:** Afegir noves capacitats. -- **Documentació:** Millorar guies i claredat. +- **Correccions d'errors:** abordar problemes de codi. +- **Noves característiques:** afegir funcionalitats. +- **Documentació:** millorar les guies i la claredat. -### Enfoc Issue-First +### Enfocament de primera incidència -Totes les contribucions han de començar amb una Issue de GitHub. +Totes les contribucions comencen amb una incidència de GitHub utilitzant les nostres plantilles bàsiques. -- **Revisar issues existents:** Cerca a [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Crear una issue:** Utilitza les plantilles adequades: - - **Errors:** Plantilla "Bug Report". - - **Funcionalitats:** Plantilla "Detailed Feature Proposal". Es requereix aprovació abans de començar. -- **Reclamar issues:** Comenta i espera l'assignació oficial. - -**Els PRs sense issues aprovades poden ser tancats.** +- **Comproveu les incidències existents**: cerqueu a [Incidències de GitHub](https://github.com/RooCodeInc/Roo-Code/issues). +- **Creeu una incidència** utilitzant: + - **Millores:** plantilla "Sol·licitud de millora" (llenguatge senzill centrat en el benefici per a l'usuari). + - **Errors:** plantilla "Informe d'error" (reproducció mínima + esperat vs real + versió). +- **Voleu treballar-hi?** Comenteu "Reclamant" a la incidència i envieu un missatge directe a **Hannes Rudolph (`hrudolph`)** a [Discord](https://discord.gg/roocode) per ser assignat. L'assignació es confirmarà al fil. +- **Les sol·licituds d'extracció han d'enllaçar a la incidència.** Les sol·licituds d'extracció no enllaçades es poden tancar. ### Decidir en què treballar -- Consulta el [Projecte GitHub](https://github.com/orgs/RooCodeInc/projects/1) per trobar "Good First Issues" no assignades. -- Per a documentació, visita [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). +- Consulteu el [Projecte de GitHub](https://github.com/orgs/RooCodeInc/projects/1) per a incidències "Incidència [No assignada]". +- Per a documents, visiteu [Documents de Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs). ### Informar d'errors -- Comprova primer els informes existents. -- Crea nous informes d'errors utilitzant la [plantilla "Bug Report"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Vulnerabilitats de seguretat:** Informa de manera privada via [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +- Comproveu primer si hi ha informes existents. +- Creeu un error nou utilitzant la [plantilla "Informe d'error"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) amb: + - Passos de reproducció clars i numerats + - Resultat esperat vs real + - Versió de Roo Code (obligatori); proveïdor/model d'API si és rellevant +- **Problemes de seguretat**: informeu de manera privada a través d' [avisos de seguretat](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). -## Procés de desenvolupament i enviament +## Procés de desenvolupament i submissió -### Configuració de desenvolupament +### Configuració del desenvolupament -1. **Fork & Clona:** +1. **Bifurcació i clonació:** ``` -git clone https://github.com/EL_TEU_USUARI/Roo-Code.git +git clone https://github.com/EL_TEU_NOM_USUARI/Roo-Code.git ``` -2. **Instal·la dependències:** +2. **Instal·leu les dependències:** ``` -npm run install:all +pnpm install ``` -3. **Depuració:** Obre amb VS Code (`F5`). +3. **Depuració:** Obriu amb VS Code (`F5`). -### Guia per escriure codi +### Directrius per escriure codi -- Un PR centrat per funcionalitat o correcció. -- Segueix les millors pràctiques d'ESLint i TypeScript. -- Escriu missatges de commit clars i descriptius que facin referència a issues (ex: `Fixes #123`). -- Proporciona proves completes (`npm test`). -- Rebaseja a la branca `main` més recent abans d'enviar. +- Una sol·licitud d'extracció centrada per característica o correcció. +- Seguiu les millors pràctiques d'ESLint i TypeScript. +- Escriviu confirmacions clares i descriptives que facin referència a incidències (p. ex., `Soluciona #123`). +- Proporcioneu proves exhaustives (`npm test`). +- Rebaseu a la branca `main` més recent abans de la submissió. -### Enviar un Pull Request +### Enviament d'una sol·licitud d'extracció -- Comença com a **PR en esborrany** si busques feedback primerenc. -- Descriu clarament els teus canvis seguint la Plantilla de Pull Request. -- Proporciona captures de pantalla/vídeos per a canvis d'UI. -- Indica si es necessiten actualitzacions de documentació. +- Comenceu com a **PR d'esborrany** si busqueu comentaris primerencs. +- Descriviu clarament els vostres canvis seguint la plantilla de sol·licitud d'extracció. +- Enllaceu la incidència a la descripció/títol de la PR (p. ex., "Soluciona #123"). +- Proporcioneu captures de pantalla/vídeos per a canvis a la interfície d'usuari. +- Indiqueu si calen actualitzacions de la documentació. -### Política de Pull Request +### Política de sol·licitud d'extracció -- Ha de fer referència a issues preaprovades i assignades. -- Els PRs que no segueixen la política poden ser tancats. -- Els PRs han de passar els tests de CI, alinear-se amb la fulla de ruta i tenir documentació clara. +- Ha de fer referència a una incidència de GitHub assignada. Per ser assignat: comenteu "Reclamant" a la incidència i envieu un missatge directe a **Hannes Rudolph (`hrudolph`)** a [Discord](https://discord.gg/roocode). L'assignació es confirmarà al fil. +- Les sol·licituds d'extracció no enllaçades es poden tancar. +- Les sol·licituds d'extracció han de passar les proves de CI, alinear-se amb el full de ruta i tenir una documentació clara. ### Procés de revisió -- **Triatge diari:** Comprovacions ràpides pels mantenidors. -- **Revisió setmanal detallada:** Avaluació exhaustiva. -- **Itera ràpidament** en base al feedback. +- **Triatge diari:** revisions ràpides per part dels mantenidors. +- **Revisió setmanal en profunditat:** avaluació completa. +- **Itereu ràpidament** en funció dels comentaris. ## Legal -En enviar un pull request, acceptes que les teves contribucions es llicenciïn sota la Llicència Apache 2.0, d'acord amb la llicència de Roo Code. +En contribuir, accepteu que les vostres contribucions es llicenciaran sota la llicència Apache 2.0, d'acord amb la llicència de Roo Code. diff --git a/locales/de/CONTRIBUTING.md b/locales/de/CONTRIBUTING.md index 4aa02794580..e7728aaa05b 100644 --- a/locales/de/CONTRIBUTING.md +++ b/locales/de/CONTRIBUTING.md @@ -13,13 +13,13 @@ # Beitrag zu Roo Code -Roo Code ist ein Community-getriebenes Projekt, und wir schätzen jeden Beitrag sehr. Für eine reibungslose Zusammenarbeit arbeiten wir nach dem [Issue-First-Ansatz](#issue-first-ansatz), was bedeutet, dass alle [Pull Requests (PRs)](#einen-pull-request-einreichen) zuerst mit einem GitHub Issue verknüpft werden müssen. Bitte lies diesen Leitfaden sorgfältig durch. +Roo Code ist ein von der Community getragenes Projekt, und wir schätzen jeden Beitrag sehr. Um die Zusammenarbeit zu optimieren, arbeiten wir nach dem [Issue-First-Ansatz](#issue-first-ansatz), was bedeutet, dass alle [Pull Requests (PRs)](#einen-pull-request-einreichen) zuerst mit einem GitHub-Issue verknüpft sein müssen. Bitte lies diesen Leitfaden sorgfältig durch. ## Inhaltsverzeichnis - [Bevor du beiträgst](#bevor-du-beiträgst) -- [Beitrag finden & planen](#beitrag-finden--planen) -- [Entwicklung & Einreichung](#entwicklung--einreichung) +- [Deinen Beitrag finden und planen](#deinen-beitrag-finden-und-planen) +- [Entwicklungs- und Einreichungsprozess](#entwicklungs-und-einreichungsprozess) - [Rechtliches](#rechtliches) ## Bevor du beiträgst @@ -30,109 +30,112 @@ Alle Mitwirkenden müssen sich an unseren [Verhaltenskodex](./CODE_OF_CONDUCT.md ### 2. Projekt-Roadmap -Unsere Roadmap gibt die Richtung des Projekts vor. Richte deine Beiträge an diesen Schlüsselzielen aus: +Unsere Roadmap gibt die Richtung des Projekts vor. Richte deine Beiträge an diesen Hauptzielen aus: ### Zuverlässigkeit an erster Stelle -- Sicherstellen, dass Diff-Bearbeitung und Befehlsausführung durchgängig zuverlässig sind. -- Reibungspunkte reduzieren, die von der regelmäßigen Nutzung abhalten. -- Reibungslosen Betrieb in allen Sprachen und auf allen Plattformen garantieren. -- Robuste Unterstützung für eine Vielzahl von KI-Anbietern und -Modellen ausbauen. +- Stelle sicher, dass die Diff-Bearbeitung und die Befehlsausführung durchweg zuverlässig sind. +- Reduziere Reibungspunkte, die von der regelmäßigen Nutzung abhalten. +- Gewährleiste einen reibungslosen Betrieb in allen Gebietsschemata und auf allen Plattformen. +- Erweitere die robuste Unterstützung für eine Vielzahl von KI-Anbietern und -Modellen. ### Verbesserte Benutzererfahrung -- Die Benutzeroberfläche für mehr Klarheit und Intuitivität optimieren. -- Den Workflow kontinuierlich verbessern, um den hohen Erwartungen gerecht zu werden, die Entwickler an täglich genutzte Tools stellen. +- Optimiere die UI/UX für Klarheit und Intuitivität. +- Verbessere kontinuierlich den Arbeitsablauf, um den hohen Erwartungen gerecht zu werden, die Entwickler an täglich genutzte Werkzeuge haben. -### Führend bei der Agentenleistung +### Führend in der Agentenleistung -- Umfassende Evaluierungsmaßstäbe (Evals) etablieren, um die Produktivität in der realen Welt zu messen. -- Es für jeden einfach machen, diese Evals durchzuführen und zu interpretieren. -- Verbesserungen liefern, die klare Steigerungen der Eval-Ergebnisse zeigen. +- Etabliere umfassende Bewertungsmaßstäbe (evals), um die Produktivität in der Praxis zu messen. +- Mache es für jeden einfach, diese Bewertungen auszuführen und zu interpretieren. +- Liefere Verbesserungen, die klare Steigerungen der Bewertungsergebnisse zeigen. -Erwähne die Ausrichtung an diesen Bereichen in deinen PRs. +Erwähne die Ausrichtung auf diese Bereiche in deinen PRs. -### 3. Werde Teil der Roo Code Community +### 3. Tritt der Roo Code Community bei -- **Hauptweg:** Tritt unserem [Discord](https://discord.gg/roocode) bei und schreibe eine DM an **Hannes Rudolph (`hrudolph`)**. -- **Alternative:** Erfahrene Mitwirkende können sich direkt über [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1) beteiligen. +- **Primär:** Tritt unserem [Discord](https://discord.gg/roocode) bei und schreibe eine DM an **Hannes Rudolph (`hrudolph`)**. +- **Alternative:** Erfahrene Mitwirkende können sich direkt über [GitHub-Projekte](https://github.com/orgs/RooCodeInc/projects/1) beteiligen. -## Beitrag finden & planen +## Deinen Beitrag finden und planen -### Beitragsarten +### Arten von Beiträgen -- **Bugfixes:** Fehler im Code beheben. -- **Neue Features:** Neue Funktionen hinzufügen. -- **Dokumentation:** Anleitungen verbessern und klarer gestalten. +- **Fehlerbehebungen:** Behebung von Code-Problemen. +- **Neue Funktionen:** Hinzufügen von Funktionalität. +- **Dokumentation:** Verbesserung von Anleitungen und Klarheit. ### Issue-First-Ansatz -Alle Beiträge müssen mit einem GitHub Issue beginnen. +Alle Beiträge beginnen mit einem GitHub-Issue unter Verwendung unserer schlanken Vorlagen. -- **Bestehende Issues prüfen**: Durchsuche die [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Issue erstellen**: Nutze die passenden Vorlagen: - - **Bugs:** "Bug Report"-Vorlage. - - **Features:** "Detailed Feature Proposal"-Vorlage. Vor dem Start ist eine Genehmigung erforderlich. -- **Issues beanspruchen**: Kommentiere und warte auf die offizielle Zuweisung. +- **Überprüfe bestehende Issues**: Suche in den [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). +- **Erstelle ein Issue** mit: + - **Verbesserungen:** Vorlage „Verbesserungsvorschlag“ (einfache Sprache mit Fokus auf den Nutzen für den Benutzer). + - **Fehler:** Vorlage „Fehlerbericht“ (minimale Reproduktion + erwartet vs. tatsächlich + Version). +- **Möchtest du daran arbeiten?** Kommentiere „Claiming“ im Issue und schreibe eine DM an **Hannes Rudolph (`hrudolph`)** auf [Discord](https://discord.gg/roocode), um zugewiesen zu werden. Die Zuweisung wird im Thread bestätigt. +- **PRs müssen auf das Issue verweisen.** Nicht verknüpfte PRs können geschlossen werden. -**PRs ohne genehmigte Issues können geschlossen werden.** +### Entscheiden, woran du arbeiten möchtest -### Was soll ich machen? +- Überprüfe das [GitHub-Projekt](https://github.com/orgs/RooCodeInc/projects/1) auf „Issue [Unassigned]“-Issues. +- Für Dokumentation besuche [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). -- Schau im [GitHub Project](https://github.com/orgs/RooCodeInc/projects/1) nach nicht zugewiesenen "Good First Issues". -- Für Dokumentation besuche das [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs) Repository. +### Fehler melden -### Bugs melden +- Überprüfe zuerst, ob bereits Berichte vorhanden sind. +- Erstelle einen neuen Fehler mit der [Vorlage „Fehlerbericht“](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) mit: + - Klaren, nummerierten Reproduktionsschritten + - Erwartetes vs. tatsächliches Ergebnis + - Roo Code-Version (erforderlich); API-Anbieter/Modell, falls relevant +- **Sicherheitsprobleme**: Melde sie privat über [Sicherheitshinweise](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). -- Prüfe zuerst, ob der Bug bereits gemeldet wurde. -- Erstelle neue Bug-Reports mit der ["Bug Report"-Vorlage](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Sicherheitslücken:** Melde diese privat über [Security Advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +## Entwicklungs- und Einreichungsprozess -## Entwicklung & Einreichung +### Entwicklungseinrichtung -### Entwicklungs-Setup - -1. **Fork & Clone:** +1. **Fork & Klonen:** ``` -git clone https://github.com/DEIN_USERNAME/Roo-Code.git +git clone https://github.com/DEIN_BENUTZERNAME/Roo-Code.git ``` 2. **Abhängigkeiten installieren:** ``` -npm run install:all +pnpm install ``` -3. **Debugging:** Öffne mit VS Code (`F5`). +3. **Debugging:** Mit VS Code öffnen (`F5`). -### Code-Richtlinien +### Richtlinien zum Schreiben von Code -- Ein fokussierter PR pro Feature oder Fix. -- Folge den ESLint und TypeScript Best Practices. -- Schreibe klare, beschreibende Commits, die auf Issues verweisen (z.B. `Fixes #123`). -- Liefere gründliche Tests (`npm test`). -- Rebase auf den neuesten `main`-Branch vor dem Einreichen. +- Ein fokussierter PR pro Funktion oder Fehlerbehebung. +- Befolge die Best Practices von ESLint und TypeScript. +- Schreibe klare, beschreibende Commits mit Verweis auf Issues (z. B. `Fixes #123`). +- Stelle gründliche Tests bereit (`npm test`). +- Rebase auf den neuesten `main`-Zweig vor der Einreichung. ### Einen Pull Request einreichen -- Beginne als **Draft PR**, wenn du frühes Feedback suchst. -- Beschreibe deine Änderungen klar und folge der Pull Request Vorlage. +- Beginne als **Entwurfs-PR**, wenn du frühzeitig Feedback einholen möchtest. +- Beschreibe deine Änderungen klar und deutlich gemäß der Pull-Request-Vorlage. +- Verknüpfe das Issue in der PR-Beschreibung/Titel (z. B. „Fixes #123“). - Stelle Screenshots/Videos für UI-Änderungen bereit. -- Gib an, ob Dokumentationsaktualisierungen notwendig sind. +- Gib an, ob Dokumentationsaktualisierungen erforderlich sind. -### Pull Request Richtlinie +### Pull-Request-Richtlinie -- Muss auf vorab genehmigte, zugewiesene Issues verweisen. -- PRs ohne Einhaltung der Richtlinie können geschlossen werden. -- PRs sollten CI-Tests bestehen, zur Roadmap passen und klare Dokumentation haben. +- Muss auf ein zugewiesenes GitHub-Issue verweisen. Um zugewiesen zu werden: Kommentiere „Claiming“ im Issue und schreibe eine DM an **Hannes Rudolph (`hrudolph`)** auf [Discord](https://discord.gg/roocode). Die Zuweisung wird im Thread bestätigt. +- Nicht verknüpfte PRs können geschlossen werden. +- PRs müssen die CI-Tests bestehen, mit der Roadmap übereinstimmen und eine klare Dokumentation haben. -### Review-Prozess +### Überprüfungsprozess -- **Tägliche Triage:** Schnelle Prüfungen durch Maintainer. -- **Wöchentliche Tiefenprüfung:** Umfassende Bewertung. -- **Zeitnah auf Feedback reagieren** und entsprechend iterieren. +- **Tägliche Triage:** Schnelle Überprüfungen durch die Betreuer. +- **Wöchentliche ausführliche Überprüfung:** Umfassende Bewertung. +- **Iteriere umgehend** basierend auf dem Feedback. ## Rechtliches -Mit deinem Beitrag erklärst du dich damit einverstanden, dass deine Beiträge unter der Apache 2.0 Lizenz lizenziert werden, konsistent mit der Lizenzierung von Roo Code. +Indem du einen Beitrag leistest, stimmst du zu, dass deine Beiträge unter der Apache-2.0-Lizenz lizenziert werden, die mit der Lizenzierung von Roo Code übereinstimmt. diff --git a/locales/es/CONTRIBUTING.md b/locales/es/CONTRIBUTING.md index a00d79559ae..a61e3b275b5 100644 --- a/locales/es/CONTRIBUTING.md +++ b/locales/es/CONTRIBUTING.md @@ -13,126 +13,129 @@ # Contribuir a Roo Code -Roo Code es un proyecto impulsado por la comunidad, y valoramos profundamente cada contribución. Para agilizar la colaboración, operamos con un enfoque [Issue-First](#enfoque-issue-first), lo que significa que todos los [Pull Requests (PRs)](#enviar-un-pull-request) deben estar vinculados primero a un Issue de GitHub. Por favor, revisa esta guía cuidadosamente. +Roo Code es un proyecto impulsado por la comunidad y valoramos profundamente cada contribución. Para agilizar la colaboración, operamos con un [enfoque de "primero la incidencia"](#enfoque-de-primero-la-incidencia), lo que significa que todas las [solicitudes de extracción (PR)](#envío-de-una-solicitud-de-extracción) deben estar primero vinculadas a una incidencia de GitHub. Por favor, revise esta guía detenidamente. -## Tabla de Contenidos +## Tabla de contenidos -- [Antes de Contribuir](#antes-de-contribuir) -- [Encontrar y Planificar tu Contribución](#encontrar-y-planificar-tu-contribución) -- [Proceso de Desarrollo y Envío](#proceso-de-desarrollo-y-envío) +- [Antes de contribuir](#antes-de-contribuir) +- [Encontrar y planificar su contribución](#encontrar-y-planificar-su-contribución) +- [Proceso de desarrollo y envío](#proceso-de-desarrollo-y-envío) - [Legal](#legal) -## Antes de Contribuir +## Antes de contribuir -### 1. Código de Conducta +### 1. Código de conducta -Todos los colaboradores deben adherirse a nuestro [Código de Conducta](./CODE_OF_CONDUCT.md). +Todos los colaboradores deben adherirse a nuestro [Código de conducta](./CODE_OF_CONDUCT.md). -### 2. Hoja de Ruta del Proyecto +### 2. Hoja de ruta del proyecto -Nuestra hoja de ruta guía la dirección del proyecto. Alinea tus contribuciones con estos objetivos clave: +Nuestra hoja de ruta guía la dirección del proyecto. Alinee sus contribuciones con estos objetivos clave: -### Confiabilidad Primero +### La fiabilidad es lo primero -- Garantizar que la edición de diferencias y la ejecución de comandos sean consistentemente confiables. -- Reducir los puntos de fricción que disuaden el uso regular. -- Garantizar un funcionamiento fluido en todos los idiomas y plataformas. -- Ampliar el soporte sólido para una amplia variedad de proveedores y modelos de IA. +- Asegúrese de que la edición de diferencias y la ejecución de comandos sean consistentemente fiables. +- Reduzca los puntos de fricción que desalientan el uso regular. +- Garantice un funcionamiento fluido en todas las localidades y plataformas. +- Amplíe el soporte robusto para una amplia variedad de proveedores y modelos de IA. -### Experiencia de Usuario Mejorada +### Experiencia de usuario mejorada -- Simplificar la interfaz de usuario para mayor claridad e intuitividad. -- Mejorar continuamente el flujo de trabajo para satisfacer las altas expectativas que los desarrolladores tienen para herramientas de uso diario. +- Agilice la interfaz de usuario/experiencia de usuario para mayor claridad e intuición. +- Mejore continuamente el flujo de trabajo para cumplir con las altas expectativas que los desarrolladores tienen de las herramientas de uso diario. -### Liderazgo en Rendimiento de Agentes +### Liderando el rendimiento de los agentes -- Establecer evaluaciones comparativas completas (evals) para medir la productividad en el mundo real. -- Facilitar que todos puedan ejecutar e interpretar estas evaluaciones fácilmente. -- Ofrecer mejoras que demuestren aumentos claros en las puntuaciones de evaluación. +- Establezca puntos de referencia de evaluación (evals) exhaustivos para medir la productividad en el mundo real. +- Facilite que todos puedan ejecutar e interpretar fácilmente estas evaluaciones. +- Envíe mejoras que demuestren un claro aumento en las puntuaciones de las evaluaciones. -Menciona la alineación con estas áreas en tus PRs. +Mencione la alineación con estas áreas en sus solicitudes de extracción. -### 3. Únete a la Comunidad Roo Code +### 3. Únase a la comunidad de Roo Code -- **Principal:** Únete a nuestro [Discord](https://discord.gg/roocode) y envía un DM a **Hannes Rudolph (`hrudolph`)**. -- **Alternativa:** Los colaboradores experimentados pueden participar directamente a través de [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). +- **Principal:** Únase a nuestro [Discord](https://discord.gg/roocode) y envíe un mensaje directo a **Hannes Rudolph (`hrudolph`)**. +- **Alternativa:** Los colaboradores experimentados pueden participar directamente a través de [Proyectos de GitHub](https://github.com/orgs/RooCodeInc/projects/1). -## Encontrar y Planificar tu Contribución +## Encontrar y planificar su contribución -### Tipos de Contribuciones +### Tipos de contribuciones -- **Corrección de errores:** Solucionar problemas en el código. -- **Nuevas funciones:** Añadir funcionalidades. -- **Documentación:** Mejorar guías y claridad. +- **Correcciones de errores:** abordar problemas de código. +- **Nuevas características:** agregar funcionalidad. +- **Documentación:** mejorar las guías y la claridad. -### Enfoque Issue-First +### Enfoque de primero la incidencia -Todas las contribuciones deben comenzar con un Issue de GitHub. +Todas las contribuciones comienzan con una incidencia de GitHub utilizando nuestras plantillas simplificadas. -- **Revisar issues existentes**: Busca en [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Crear un issue**: Usa las plantillas apropiadas: - - **Errores:** Plantilla "Bug Report". - - **Funciones:** Plantilla "Detailed Feature Proposal". Se requiere aprobación antes de comenzar. -- **Reclamar issues**: Comenta y espera la asignación oficial. +- **Compruebe las incidencias existentes**: busque en [Incidencias de GitHub](https://github.com/RooCodeInc/Roo-Code/issues). +- **Cree una incidencia** utilizando: + - **Mejoras:** plantilla "Solicitud de mejora" (lenguaje sencillo centrado en el beneficio del usuario). + - **Errores:** plantilla "Informe de error" (reproducción mínima + esperado vs. real + versión). +- **¿Quiere trabajar en ello?** Comente "Reclamando" en la incidencia y envíe un mensaje directo a **Hannes Rudolph (`hrudolph`)** en [Discord](https://discord.gg/roocode) para que se le asigne. La asignación se confirmará en el hilo. +- **Las solicitudes de extracción deben enlazar a la incidencia.** Las solicitudes de extracción no enlazadas pueden cerrarse. -**Los PRs sin issues aprobados pueden ser cerrados.** +### Decidir en qué trabajar -### Decidir en Qué Trabajar +- Consulte el [Proyecto de GitHub](https://github.com/orgs/RooCodeInc/projects/1) para ver las incidencias "Incidencia [Sin asignar]". +- Para la documentación, visite [Documentos de Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs). -- Revisa el [Proyecto GitHub](https://github.com/orgs/RooCodeInc/projects/1) para "Good First Issues" no asignados. -- Para documentación, visita [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). +### Informar de errores -### Reportar Errores +- Compruebe primero si existen informes. +- Cree un nuevo error utilizando la [plantilla "Informe de error"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) con: + - Pasos de reproducción claros y numerados + - Resultado esperado vs. real + - Versión de Roo Code (obligatorio); proveedor/modelo de API si es relevante +- **Problemas de seguridad**: informe de forma privada a través de [avisos de seguridad](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). -- Primero verifica si ya existen reportes. -- Crea nuevos reportes de errores usando la [plantilla "Bug Report"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Problemas de seguridad**: Reporta de forma privada a través de [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +## Proceso de desarrollo y envío -## Proceso de Desarrollo y Envío +### Configuración de desarrollo -### Configuración de Desarrollo - -1. **Fork & Clona:** +1. **Bifurcar y clonar:** ``` -git clone https://github.com/TU_USUARIO/Roo-Code.git +git clone https://github.com/SU_NOMBRE_DE_USUARIO/Roo-Code.git ``` -2. **Instalar Dependencias:** +2. **Instalar dependencias:** ``` -npm run install:all +pnpm install ``` -3. **Depuración:** Abre con VS Code (`F5`). +3. **Depuración:** Abra con VS Code (`F5`). -### Guía para Escribir Código +### Directrices para escribir código -- Un PR enfocado por función o corrección. -- Sigue las mejores prácticas de ESLint y TypeScript. -- Escribe commits claros y descriptivos que referencien issues (ej., `Fixes #123`). -- Proporciona pruebas exhaustivas (`npm test`). -- Rebase sobre la última rama `main` antes de enviar. +- Una solicitud de extracción centrada por característica o corrección. +- Siga las mejores prácticas de ESLint y TypeScript. +- Escriba confirmaciones claras y descriptivas que hagan referencia a las incidencias (p. ej., `Corrige #123`). +- Proporcione pruebas exhaustivas (`npm test`). +- Rebase a la rama `main` más reciente antes del envío. -### Enviar un Pull Request +### Envío de una solicitud de extracción -- Comienza como **PR en Borrador** si buscas feedback temprano. -- Describe claramente tus cambios siguiendo la Plantilla de Pull Request. -- Proporciona capturas de pantalla/videos para cambios en la UI. -- Indica si son necesarias actualizaciones de documentación. +- Comience como una **PR en borrador** si busca comentarios tempranos. +- Describa claramente sus cambios siguiendo la plantilla de solicitud de extracción. +- Enlace la incidencia en la descripción/título de la PR (p. ej., "Corrige #123"). +- Proporcione capturas de pantalla/vídeos para los cambios en la interfaz de usuario. +- Indique si es necesario actualizar la documentación. -### Política de Pull Request +### Política de solicitud de extracción -- Debe referenciar issues preaprobados y asignados. -- Los PRs que no cumplan con la política pueden ser cerrados. -- Los PRs deben pasar las pruebas de CI, alinearse con la hoja de ruta y tener documentación clara. +- Debe hacer referencia a una incidencia de GitHub asignada. Para que se le asigne: comente "Reclamando" en la incidencia y envíe un mensaje directo a **Hannes Rudolph (`hrudolph`)** en [Discord](https://discord.gg/roocode). La asignación se confirmará en el hilo. +- Las solicitudes de extracción no enlazadas pueden cerrarse. +- Las solicitudes de extracción deben pasar las pruebas de CI, estar alineadas con la hoja de ruta y tener una documentación clara. -### Proceso de Revisión +### Proceso de revisión -- **Triage Diario:** Revisiones rápidas por parte de los mantenedores. -- **Revisión Semanal en Profundidad:** Evaluación integral. -- **Itera rápidamente** basándote en el feedback. +- **Clasificación diaria:** comprobaciones rápidas por parte de los mantenedores. +- **Revisión semanal en profundidad:** evaluación exhaustiva. +- **Itere rápidamente** en función de los comentarios. ## Legal -Al contribuir, aceptas que tus contribuciones serán licenciadas bajo la Licencia Apache 2.0, consistente con la licencia de Roo Code. +Al contribuir, acepta que sus contribuciones se licenciarán bajo la Licencia Apache 2.0, de acuerdo con la licencia de Roo Code. diff --git a/locales/fr/CONTRIBUTING.md b/locales/fr/CONTRIBUTING.md index da703ef9f41..6f8e89430a4 100644 --- a/locales/fr/CONTRIBUTING.md +++ b/locales/fr/CONTRIBUTING.md @@ -13,12 +13,12 @@ # Contribuer à Roo Code -Roo Code est un projet porté par la communauté, et chaque contribution compte beaucoup pour nous. Pour fluidifier la collaboration, nous fonctionnons selon une [approche Issue-First](#approche-issue-first), ce qui signifie que toutes les [Pull Requests (PRs)](#soumettre-une-pull-request) doivent d'abord être liées à un ticket GitHub. Lis attentivement ce guide. +Roo Code est un projet communautaire, et nous apprécions profondément chaque contribution. Pour simplifier la collaboration, nous fonctionnons sur une base [d'abord l'issue](#approche-issue-first), ce qui signifie que toutes les [Pull Requests (PRs)](#soumettre-une-pull-request) doivent d'abord être liées à une Issue GitHub. Veuillez lire attentivement ce guide. ## Table des matières - [Avant de contribuer](#avant-de-contribuer) -- [Trouver et planifier ta contribution](#trouver-et-planifier-ta-contribution) +- [Trouver et planifier votre contribution](#trouver-et-planifier-votre-contribution) - [Processus de développement et de soumission](#processus-de-développement-et-de-soumission) - [Légal](#légal) @@ -26,113 +26,116 @@ Roo Code est un projet porté par la communauté, et chaque contribution compte ### 1. Code de conduite -Tous les contributeurs doivent respecter notre [Code de conduite](./CODE_OF_CONDUCT.md). +Tous les contributeurs doivent adhérer à notre [Code de conduite](./CODE_OF_CONDUCT.md). ### 2. Feuille de route du projet -Notre feuille de route guide la direction du projet. Aligne tes contributions avec ces objectifs clés : +Notre feuille de route guide la direction du projet. Alignez vos contributions sur ces objectifs clés : -### Fiabilité avant tout +### La fiabilité d'abord -- Garantir que l'édition des différences et l'exécution des commandes soient toujours fiables. -- Réduire les points de friction qui découragent l'utilisation régulière. -- Assurer un fonctionnement fluide dans toutes les langues et sur toutes les plateformes. -- Étendre le support robuste pour une grande variété de fournisseurs et de modèles d'IA. +- Assurez-vous que l'édition de diff et l'exécution de commandes sont fiables de manière constante. +- Réduisez les points de friction qui découragent une utilisation régulière. +- Garantissez un fonctionnement fluide dans toutes les langues et sur toutes les plateformes. +- Étendez le support robuste à une grande variété de fournisseurs et de modèles d'IA. ### Expérience utilisateur améliorée -- Simplifier l'interface utilisateur pour plus de clarté et d'intuitivité. -- Améliorer continuellement le flux de travail pour répondre aux attentes élevées des développeurs. +- Simplifiez l'UI/UX pour plus de clarté et d'intuitivité. +- Améliorez continuellement le flux de travail pour répondre aux attentes élevées des développeurs pour les outils à usage quotidien. -### Leadership en performance des agents +### Leader en performance d'agent -- Établir des référentiels d'évaluation (evals) complets pour mesurer la productivité réelle. -- Permettre à chacun d'exécuter et d'interpréter facilement ces évaluations. -- Fournir des améliorations qui démontrent des augmentations claires dans les scores d'évaluation. +- Établissez des benchmarks d'évaluation complets (evals) pour mesurer la productivité en conditions réelles. +- Facilitez l'exécution et l'interprétation de ces évaluations par tout le monde. +- Livrez des améliorations qui démontrent des augmentations claires des scores d'évaluation. -Mentionne l'alignement avec ces domaines dans tes PRs. +Mentionnez l'alignement avec ces domaines dans vos PRs. -### 3. Rejoindre la communauté Roo Code +### 3. Rejoignez la communauté Roo Code -- **Principal :** Rejoins notre [Discord](https://discord.gg/roocode) et envoie un DM à **Hannes Rudolph (`hrudolph`)**. -- **Alternative :** Les contributeurs expérimentés peuvent participer directement via [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). +- **Principal :** Rejoignez notre [Discord](https://discord.gg/roocode) et envoyez un DM à **Hannes Rudolph (`hrudolph`)**. +- **Alternative :** Les contributeurs expérimentés peuvent s'engager directement via les [Projets GitHub](https://github.com/orgs/RooCodeInc/projects/1). -## Trouver et planifier ta contribution +## Trouver et planifier votre contribution ### Types de contributions -- **Corrections de bugs :** Résoudre des problèmes dans le code. -- **Nouvelles fonctionnalités :** Ajouter de nouvelles fonctions. +- **Corrections de bugs :** Résoudre les problèmes de code. +- **Nouvelles fonctionnalités :** Ajouter des fonctionnalités. - **Documentation :** Améliorer les guides et la clarté. ### Approche Issue-First -Toutes les contributions doivent commencer par un ticket GitHub. +Toutes les contributions commencent par une Issue GitHub en utilisant nos modèles simples. -- **Vérifier les tickets existants :** Cherche dans les [Issues GitHub](https://github.com/RooCodeInc/Roo-Code/issues). -- **Créer un ticket :** Utilise les modèles appropriés : - - **Bugs :** Modèle "Bug Report". - - **Fonctionnalités :** Modèle "Detailed Feature Proposal". Approbation requise avant de commencer. -- **Réclamer des tickets :** Commente et attends l'assignation officielle. - -**Les PRs sans tickets approuvés peuvent être fermées.** +- **Vérifiez les issues existantes** : Recherchez dans les [Issues GitHub](https://github.com/RooCodeInc/Roo-Code/issues). +- **Créez une issue** en utilisant : + - **Améliorations :** Modèle "Demande d'amélioration" (langage simple axé sur l'avantage pour l'utilisateur). + - **Bugs :** Modèle "Rapport de bug" (reproduction minimale + attendu vs réel + version). +- **Vous voulez y travailler ?** Commentez "Claiming" sur l'issue et envoyez un DM à **Hannes Rudolph (`hrudolph`)** sur [Discord](https://discord.gg/roocode) pour être assigné. L'assignation sera confirmée dans le fil de discussion. +- **Les PRs doivent être liées à l'issue.** Les PRs non liées peuvent être fermées. ### Décider sur quoi travailler -- Consulte le [Projet GitHub](https://github.com/orgs/RooCodeInc/projects/1) pour les "Good First Issues" non assignés. -- Pour la documentation, visite [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). +- Consultez le [Projet GitHub](https://github.com/orgs/RooCodeInc/projects/1) pour les issues "Issue [Non assignée]". +- Pour la documentation, visitez [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). ### Signaler des bugs -- Vérifie d'abord les rapports existants. -- Crée de nouveaux rapports de bugs avec le [modèle "Bug Report"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Failles de sécurité :** Signale-les en privé via [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +- Vérifiez d'abord les rapports existants. +- Créez un nouveau bug en utilisant le [modèle "Rapport de bug"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) avec : + - Des étapes de reproduction claires et numérotées + - Résultat attendu vs réel + - Version de Roo Code (requise) ; fournisseur/modèle d'API si pertinent +- **Problèmes de sécurité** : Signalez-les en privé via les [avis de sécurité](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). ## Processus de développement et de soumission ### Configuration du développement -1. **Fork & Clone :** +1. **Fork & Cloner :** ``` -git clone https://github.com/TON_UTILISATEUR/Roo-Code.git +git clone https://github.com/VOTRE_NOM_UTILISATEUR/Roo-Code.git ``` 2. **Installer les dépendances :** ``` -npm run install:all +pnpm install ``` -3. **Débogage :** Ouvre avec VS Code (`F5`). +3. **Débogage :** Ouvrir avec VS Code (`F5`). -### Guide d'écriture du code +### Lignes directrices pour l'écriture de code - Une PR ciblée par fonctionnalité ou correction. -- Suis les bonnes pratiques ESLint et TypeScript. -- Écris des commits clairs et descriptifs référençant les tickets (ex : `Fixes #123`). -- Fournis des tests complets (`npm test`). -- Rebase sur la dernière branche `main` avant de soumettre. +- Suivez les meilleures pratiques d'ESLint et de TypeScript. +- Rédigez des commits clairs et descriptifs faisant référence aux issues (par exemple, `Fixes #123`). +- Fournissez des tests approfondis (`npm test`). +- Rebasez sur la dernière branche `main` avant la soumission. ### Soumettre une Pull Request -- Commence par un **brouillon de PR** si tu cherches un feedback précoce. -- Décris clairement tes changements en suivant le modèle de Pull Request. -- Fournis des captures d'écran/vidéos pour les changements d'interface. -- Indique si des mises à jour de documentation sont nécessaires. +- Commencez par une **PR en brouillon** si vous recherchez des commentaires précoces. +- Décrivez clairement vos changements en suivant le modèle de Pull Request. +- Liez l'issue dans la description/le titre de la PR (par exemple, "Fixes #123"). +- Fournissez des captures d'écran/vidéos pour les changements d'interface utilisateur. +- Indiquez si des mises à jour de la documentation sont nécessaires. ### Politique de Pull Request -- Doit référencer des tickets pré-approuvés et assignés. -- Les PRs ne respectant pas cette politique peuvent être fermées. -- Les PRs doivent passer les tests CI, s'aligner avec la feuille de route et avoir une documentation claire. +- Doit faire référence à une Issue GitHub assignée. Pour être assigné : commentez "Claiming" sur l'issue et envoyez un DM à **Hannes Rudolph (`hrudolph`)** sur [Discord](https://discord.gg/roocode). L'assignation sera confirmée dans le fil de discussion. +- Les PRs non liées peuvent être fermées. +- Les PRs doivent passer les tests d'intégration continue, s'aligner sur la feuille de route et avoir une documentation claire. -### Processus de revue +### Processus de révision - **Triage quotidien :** Vérifications rapides par les mainteneurs. -- **Revue hebdomadaire approfondie :** Évaluation complète. -- **Itère rapidement** sur la base du feedback. +- **Révision hebdomadaire approfondie :** Évaluation complète. +- **Itérez rapidement** en fonction des commentaires. ## Légal -En contribuant, tu acceptes que tes contributions soient sous licence Apache 2.0, conformément à la licence de Roo Code. +En contribuant, vous acceptez que vos contributions soient sous licence Apache 2.0, conformément à la licence de Roo Code. diff --git a/locales/hi/CONTRIBUTING.md b/locales/hi/CONTRIBUTING.md index 3bac1ee7248..e72a04ec8db 100644 --- a/locales/hi/CONTRIBUTING.md +++ b/locales/hi/CONTRIBUTING.md @@ -11,128 +11,131 @@ -# Roo Code में योगदान करें +# Roo Code में योगदान -Roo Code एक समुदाय-आधारित प्रोजेक्ट है और हम हर योगदान को बहुत महत्व देते हैं। सहयोग को सरल बनाने के लिए, हम [Issue-First](#issue-first-एप्रोच) पद्धति अपनाते हैं, जिसका अर्थ है कि सभी [Pull Requests (PRs)](#pull-request-सबमिट-करना) को पहले GitHub Issue से जोड़ना आवश्यक है। कृपया इस गाइड को ध्यान से पढ़ें। +Roo Code एक समुदाय-संचालित परियोजना है, और हम हर योगदान को बहुत महत्व देते हैं। सहयोग को सुव्यवस्थित करने के لیے, हम [पहले-समस्या दृष्टिकोण](#समस्या-पहले-दृष्टिकोण) पर काम करते हैं, जिसका अर्थ है कि सभी [पुल अनुरोध (पीआर)](#एक-पुल-अनुरोध-सबमिट-करना) पहले एक गिटहब समस्या से जुड़े होने चाहिए। कृपया इस गाइड की सावधानीपूर्वक समीक्षा करें। -## विषय सूची +## विषय-सूची - [योगदान करने से पहले](#योगदान-करने-से-पहले) -- [अपना योगदान ढूंढना और योजना बनाना](#अपना-योगदान-ढूंढना-और-योजना-बनाना) -- [विकास और सबमिशन प्रक्रिया](#विकास-और-सबमिशन-प्रक्रिया) +- [अपना योगदान ढूँढना और योजना बनाना](#अपना-योगदान-ढूँढना-और-योजना-बनाना) +- [विकास और प्रस्तुत करने की प्रक्रिया](#विकास-और-प्रस्तुत-करने-की-प्रक्रिया) - [कानूनी](#कानूनी) ## योगदान करने से पहले ### 1. आचार संहिता -सभी योगदानकर्ताओं को हमारी [आचार संहिता](./CODE_OF_CONDUCT.md) का पालन करना चाहिए। +सभी योगदानकर्ताओं को हमारी [आचार संहिता](./CODE_OF_CONDUCT.md) का पालन करना होगा। -### 2. प्रोजेक्ट रोडमैप +### 2. परियोजना का रोडमैप -हमारा रोडमैप प्रोजेक्ट की दिशा तय करता है। अपने योगदान को इन प्रमुख लक्ष्यों के साथ संरेखित करें: +हमारा रोडमैप परियोजना की दिशा का मार्गदर्शन करता है। अपने योगदानों को इन प्रमुख लक्ष्यों के साथ संरेखित करें: ### विश्वसनीयता पहले -- सुनिश्चित करें कि diff एडिटिंग और कमांड एक्जीक्यूशन लगातार विश्वसनीय हों -- नियमित उपयोग को हतोत्साहित करने वाले फ्रिक्शन पॉइंट्स को कम करें -- सभी भाषाओं और प्लेटफॉर्म्स पर सुचारू संचालन की गारंटी दें -- विभिन्न AI प्रदाताओं और मॉडल्स के लिए मजबूत समर्थन का विस्तार करें +- सुनिश्चित करें कि डिफ़ संपादन और कमांड निष्पादन लगातार विश्वसनीय हैं। +- नियमित उपयोग को रोकने वाले घर्षण बिंदुओं को कम करें। +- सभी लोकेल और प्लेटफार्मों पर सुचारू संचालन की गारंटी दें। +- विभिन्न प्रकार के एआई प्रदाताओं और मॉडलों के लिए मजबूत समर्थन का विस्तार करें। -### बेहतर उपयोगकर्ता अनुभव +### उन्नत उपयोगकर्ता अनुभव -- स्पष्टता और सहजता के लिए UI/UX को सरल बनाएं -- डेवलपर्स के उच्च अपेक्षाओं को पूरा करने के लिए वर्कफ़्लो में निरंतर सुधार करें +- स्पष्टता और सहजता के लिए यूआई/यूएक्स को सुव्यवस्थित करें। +- दैनिक उपयोग के उपकरणों के लिए डेवलपर्स की उच्च अपेक्षाओं को पूरा करने के लिए वर्कफ़्लो में लगातार सुधार करें। ### एजेंट प्रदर्शन में अग्रणी -- वास्तविक दुनिया की उत्पादकता को मापने के लिए व्यापक मूल्यांकन बेंचमार्क (evals) स्थापित करें -- हर किसी के लिए इन मूल्यांकनों को आसानी से चलाना और समझना संभव बनाएं -- ऐसे सुधार लाएं जो मूल्यांकन स्कोर में स्पष्ट वृद्धि दिखाएं +- वास्तविक दुनिया की उत्पादकता को मापने के लिए व्यापक मूल्यांकन बेंचमार्क (evals) स्थापित करें। +- सभी के लिए इन मूल्यांकनों को आसानी से चलाना और व्याख्या करना आसान बनाएं। +- ऐसे सुधार भेजें जो मूल्यांकन स्कोर में स्पष्ट वृद्धि प्रदर्शित करते हैं। -अपने PR में इन क्षेत्रों से संबंधित कार्य का उल्लेख करें। +अपने पीआर में इन क्षेत्रों के साथ संरेखण का उल्लेख करें। -### 3. Roo Code कम्युनिटी से जुड़ें +### 3. Roo Code समुदाय में शामिल हों -- **मुख्य तरीका:** हमारे [Discord](https://discord.gg/roocode) से जुड़ें और **Hannes Rudolph (`hrudolph`)** को DM भेजें। -- **विकल्प:** अनुभवी योगदानकर्ता [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1) के माध्यम से सीधे भाग ले सकते हैं। +- **प्राथमिक:** हमारे [डिस्कॉर्ड](https://discord.gg/roocode) में शामिल हों और **Hannes Rudolph (`hrudolph`)** को डीएम करें। +- **वैकल्पिक:** अनुभवी योगदानकर्ता [गिटहब प्रोजेक्ट्स](https://github.com/orgs/RooCodeInc/projects/1) के माध्यम से सीधे जुड़ सकते हैं। -## अपना योगदान ढूंढना और योजना बनाना +## अपना योगदान ढूँढना और योजना बनाना ### योगदान के प्रकार -- **बग फिक्स:** कोड की समस्याओं को हल करना। -- **नई विशेषताएं:** नई कार्यक्षमता जोड़ना। -- **डॉक्युमेंटेशन:** गाइड सुधारना और स्पष्टता बढ़ाना। +- **बग फिक्स:** कोड समस्याओं का समाधान करना। +- **नई सुविधाएँ:** कार्यक्षमता जोड़ना। +- **दस्तावेज़ीकरण:** गाइड और स्पष्टता में सुधार। -### Issue-First एप्रोच +### समस्या-पहले दृष्टिकोण -हर योगदान GitHub Issue से शुरू होना चाहिए। +सभी योगदान हमारे पतले टेम्पलेट्स का उपयोग करके एक गिटहब समस्या से शुरू होते हैं। -- **मौजूदा Issues देखें:** [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) में खोजें। -- **Issue बनाएं:** उपयुक्त टेम्पलेट का उपयोग करें: - - **बग:** "Bug Report" टेम्पलेट। - - **फीचर्स:** "Detailed Feature Proposal" टेम्पलेट। शुरू करने से पहले अनुमोदन आवश्यक है। -- **Issue क्लेम करें:** कमेंट करें और आधिकारिक असाइनमेंट का इंतजार करें। +- **मौजूदा समस्याओं की जाँच करें**: [गिटहब समस्याएँ](https://github.com/RooCodeInc/Roo-Code/issues) में खोजें। +- **एक समस्या बनाएँ** का उपयोग करके: + - **सुधार:** "सुधार अनुरोध" टेम्पलेट (उपयोगकर्ता लाभ पर केंद्रित सरल भाषा)। + - **बग:** "बग रिपोर्ट" टेम्पलेट (न्यूनतम प्रतिकृति + अपेक्षित बनाम वास्तविक + संस्करण)। +- **इस पर काम करना चाहते हैं?** समस्या पर "दावा करना" टिप्पणी करें और असाइन होने के लिए [डिस्कॉर्ड](https://discord.gg/roocode) पर **Hannes Rudolph (`hrudolph`)** को डीएम करें। असाइनमेंट की पुष्टि थ्रेड में की जाएगी। +- **पीआर को समस्या से लिंक करना होगा।** अनलिंक किए गए पीआर बंद किए जा सकते हैं। -**अनुमोदित Issue के बिना PR बंद किए जा सकते हैं।** +### क्या काम करना है यह तय करना -### क्या काम करें चुनना +- "समस्या [असाइन नहीं की गई]" समस्याओं के लिए [गिटहब प्रोजेक्ट](https://github.com/orgs/RooCodeInc/projects/1) की जाँच करें। +- दस्तावेज़ों के लिए, [Roo Code दस्तावेज़](https://github.com/RooCodeInc/Roo-Code-Docs) पर जाएँ। -- [GitHub प्रोजेक्ट](https://github.com/orgs/RooCodeInc/projects/1) में असाइन न किए गए "Good First Issues" देखें। -- डॉक्युमेंटेशन के लिए, [Roo Code Docs](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) के माध्यम से निजी तौर पर रिपोर्ट करें। -- पहले मौजूदा रिपोर्ट देखें। -- ["Bug Report" टेम्पलेट](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) का उपयोग करके नए बग रिपोर्ट बनाएं। -- **सुरक्षा कमजोरियां:** [security advisories](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. **डीबगिंग:** वीएस कोड (`F5`) के साथ खोलें। -### कोड लिखने के दिशा-निर्देश +### कोड लिखने के दिशानिर्देश -- प्रति फीचर या फिक्स एक फोकस्ड PR। -- ESLint और TypeScript बेस्ट प्रैक्टिस का पालन करें। -- स्पष्ट, वर्णनात्मक कमिट मैसेज लिखें जो Issues को रेफर करें (जैसे `Fixes #123`)। -- पूर्ण टेस्टिंग प्रदान करें (`npm test`)। -- सबमिट करने से पहले अपनी ब्रांच को नवीनतम `main` पर रीबेस करें। +- प्रति सुविधा या फिक्स एक केंद्रित पीआर। +- ESLint और TypeScript की सर्वोत्तम प्रथाओं का पालन करें। +- समस्याओं का संदर्भ देने वाले स्पष्ट, वर्णनात्मक कमिट लिखें (उदाहरण के लिए, `फिक्स #123`)। +- पूरी तरह से परीक्षण प्रदान करें (`npm test`)। +- प्रस्तुत करने से पहले नवीनतम `main` शाखा पर रीबेस करें। -### Pull Request सबमिट करना +### एक पुल अनुरोध सबमिट करना -- अगर आप शुरुआती फीडबैक चाहते हैं तो **ड्राफ्ट PR** से शुरू करें। -- Pull Request टेम्पलेट का पालन करते हुए अपने परिवर्तनों का स्पष्ट वर्णन करें। -- UI परिवर्तनों के लिए स्क्रीनशॉट/वीडियो प्रदान करें। -- बताएं कि क्या डॉक्युमेंटेशन अपडेट आवश्यक हैं। +- यदि आप जल्दी प्रतिक्रिया चाहते हैं तो **ड्राफ्ट पीआर** के रूप में शुरू करें। +- पुल अनुरोध टेम्पलेट का पालन करते हुए अपने परिवर्तनों का स्पष्ट रूप से वर्णन करें। +- पीआर विवरण/शीर्षक में समस्या को लिंक करें (उदाहरण के लिए, "फिक्स #123")। +- यूआई परिवर्तनों के लिए स्क्रीनशॉट/वीडियो प्रदान करें। +- इंगित करें कि क्या दस्तावेज़ीकरण अद्यतन आवश्यक हैं। -### Pull Request नीति +### पुल अनुरोध नीति -- पूर्व-अनुमोदित और असाइन किए गए Issues का संदर्भ देना चाहिए। -- नीति का पालन न करने वाले PR बंद किए जा सकते हैं। -- PR को CI टेस्ट पास करना चाहिए, रोडमैप से मेल खाना चाहिए, और स्पष्ट डॉक्युमेंटेशन होनी चाहिए। +- एक असाइन की गई गिटहब समस्या का संदर्भ देना होगा। असाइन होने के लिए: समस्या पर "दावा करना" टिप्पणी करें और [डिस्कॉर्ड](https://discord.gg/roocode) पर **Hannes Rudolph (`hrudolph`)** को डीएम करें। असाइनमेंट की पुष्टि थ्रेड में की जाएगी। +- अनलिंक किए गए पीआर बंद किए जा सकते हैं। +- पीआर को सीआई परीक्षण पास करना होगा, रोडमैप के साथ संरेखित होना होगा, और स्पष्ट दस्तावेज़ीकरण होना होगा। ### समीक्षा प्रक्रिया -- **दैनिक ट्रायज:** मेंटेनर्स द्वारा त्वरित जांच। +- **दैनिक ट्राइएज:** अनुरक्षकों द्वारा त्वरित जाँच। - **साप्ताहिक गहन समीक्षा:** व्यापक मूल्यांकन। -- **फीडबैक के आधार पर तेजी से सुधार** करें। +- **प्रतिक्रिया के आधार पर तुरंत पुनरावृति करें**। ## कानूनी -Pull Request सबमिट करके, आप सहमत होते हैं कि आपके योगदान Roo Code के लाइसेंसिंग के अनुरूप Apache 2.0 लाइसेंस के तहत लाइसेंस किए जाएंगे। +योगदान करके, आप सहमत हैं कि आपके योगदान अपाचे 2.0 लाइसेंस के तहत लाइसेंस प्राप्त होंगे, जो Roo Code के लाइसेंस के अनुरूप है। diff --git a/locales/id/CONTRIBUTING.md b/locales/id/CONTRIBUTING.md index 7f22848b225..5af7607d7c7 100644 --- a/locales/id/CONTRIBUTING.md +++ b/locales/id/CONTRIBUTING.md @@ -13,16 +13,16 @@ # Berkontribusi pada Roo Code -Roo Code adalah proyek yang didorong oleh komunitas, dan kami sangat menghargai setiap kontribusi. Untuk memperlancar kolaborasi, kami beroperasi berdasarkan pendekatan [Issue-First](#issue-first-approach), yang berarti semua [Pull Request (PR)](#submitting-a-pull-request) harus terlebih dahulu ditautkan ke GitHub Issue. Harap tinjau panduan ini dengan cermat. +Roo Code adalah proyek yang digerakkan oleh komunitas, dan kami sangat menghargai setiap kontribusi. Untuk menyederhanakan kolaborasi, kami beroperasi dengan dasar [Pendekatan Masalah-Dulu](#pendekatan-masalah-dulu), yang berarti semua [Pull Request (PR)](#mengajukan-pull-request) harus terlebih dahulu ditautkan ke Masalah GitHub. Harap tinjau panduan ini dengan cermat. ## Daftar Isi -- [Sebelum Kamu Berkontribusi](#before-you-contribute) -- [Mencari & Merencanakan Kontribusi Kamu](#finding--planning-your-contribution) -- [Proses Pengembangan & Pengiriman](#development--submission-process) -- [Legal](#legal) +- [Sebelum Anda Berkontribusi](#sebelum-anda-berkontribusi) +- [Menemukan & Merencanakan Kontribusi Anda](#menemukan--merencanakan-kontribusi-anda) +- [Proses Pengembangan & Pengajuan](#proses-pengembangan--pengajuan) +- [Hukum](#hukum) -## Sebelum Kamu Berkontribusi +## Sebelum Anda Berkontribusi ### 1. Kode Etik @@ -30,34 +30,34 @@ Semua kontributor harus mematuhi [Kode Etik](./CODE_OF_CONDUCT.md) kami. ### 2. Peta Jalan Proyek -Peta jalan kami memandu arah proyek. Selaraskan kontribusi kamu dengan tujuan utama ini: +Peta jalan kami memandu arah proyek. Sejajarkan kontribusi Anda dengan tujuan-tujuan utama ini: ### Keandalan Utama -- Pastikan pengeditan diff dan eksekusi perintah secara konsisten dapat diandalkan. +- Pastikan pengeditan diff dan eksekusi perintah secara konsisten andal. - Kurangi titik gesekan yang menghalangi penggunaan rutin. -- Jamin operasi yang lancar di semua lokal dan platform. +- Jamin kelancaran operasi di semua lokal dan platform. - Perluas dukungan yang kuat untuk berbagai penyedia dan model AI. ### Pengalaman Pengguna yang Ditingkatkan - Sederhanakan UI/UX untuk kejelasan dan intuitivitas. -- Terus tingkatkan alur kerja untuk memenuhi ekspektasi tinggi yang dimiliki developer terhadap tools penggunaan sehari-hari. +- Terus tingkatkan alur kerja untuk memenuhi harapan tinggi yang dimiliki pengembang untuk alat yang digunakan sehari-hari. -### Memimpin dalam Performa Agen +### Memimpin dalam Kinerja Agen -- Tetapkan benchmark evaluasi komprehensif (evals) untuk mengukur produktivitas dunia nyata. -- Permudah semua orang untuk menjalankan dan menafsirkan evals ini. -- Kirimkan perbaikan yang menunjukkan peningkatan jelas dalam skor eval. +- Tetapkan tolok ukur evaluasi (eval) yang komprehensif untuk mengukur produktivitas dunia nyata. +- Permudah semua orang untuk menjalankan dan menafsirkan eval ini dengan mudah. +- Kirimkan perbaikan yang menunjukkan peningkatan yang jelas dalam skor eval. -Sebutkan keselarasan dengan area ini di PR kamu. +Sebutkan keselarasan dengan area-area ini di PR Anda. -### 3. Bergabung dengan Komunitas Roo Code +### 3. Bergabunglah dengan Komunitas Roo Code -- **Utama:** Bergabunglah dengan [Discord](https://discord.gg/roocode) kami dan DM **Hannes Rudolph (`hrudolph`)**. -- **Alternatif:** Kontributor berpengalaman dapat berinteraksi langsung melalui [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). +- **Utama:** Bergabunglah dengan [Discord](https://discord.gg/roocode) kami dan kirim DM ke **Hannes Rudolph (`hrudolph`)**. +- **Alternatif:** Kontributor berpengalaman dapat terlibat langsung melalui [Proyek GitHub](https://github.com/orgs/RooCodeInc/projects/1). -## Mencari & Merencanakan Kontribusi Kamu +## Menemukan & Merencanakan Kontribusi Anda ### Jenis Kontribusi @@ -65,40 +65,42 @@ Sebutkan keselarasan dengan area ini di PR kamu. - **Fitur Baru:** Menambahkan fungsionalitas. - **Dokumentasi:** Meningkatkan panduan dan kejelasan. -### Pendekatan Issue-First +### Pendekatan Masalah-Dulu -Semua kontribusi harus dimulai dengan GitHub Issue. +Semua kontribusi dimulai dengan Masalah GitHub menggunakan template ramping kami. -- **Periksa isu yang ada**: Cari di [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Buat isu**: Gunakan template yang sesuai: - - **Bug:** Template "Bug Report". - - **Fitur:** Template "Detailed Feature Proposal". Persetujuan diperlukan sebelum memulai. -- **Klaim isu**: Beri komentar dan tunggu penugasan resmi. - -**PR tanpa isu yang disetujui dapat ditutup.** +- **Periksa masalah yang ada**: Cari di [Masalah GitHub](https://github.com/RooCodeInc/Roo-Code/issues). +- **Buat masalah** menggunakan: + - **Penyempurnaan:** Template "Permintaan Penyempurnaan" (bahasa sederhana yang berfokus pada manfaat pengguna). + - **Bug:** Template "Laporan Bug" (repro minimal + yang diharapkan vs aktual + versi). +- **Ingin mengerjakannya?** Beri komentar "Mengklaim" pada masalah tersebut dan kirim DM ke **Hannes Rudolph (`hrudolph`)** di [Discord](https://discord.gg/roocode) untuk ditugaskan. Penugasan akan dikonfirmasi di utas. +- **PR harus menautkan ke masalah.** PR yang tidak tertaut dapat ditutup. ### Memutuskan Apa yang Akan Dikerjakan -- Periksa [GitHub Project](https://github.com/orgs/RooCodeInc/projects/1) untuk "Good First Issues" yang belum ditugaskan. -- Untuk dokumen, kunjungi [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). +- Periksa [Proyek GitHub](https://github.com/orgs/RooCodeInc/projects/1) untuk masalah "Masalah [Belum Ditugaskan]". +- Untuk dokumentasi, kunjungi [Dokumentasi Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs). ### Melaporkan Bug - Periksa laporan yang ada terlebih dahulu. -- Buat bug baru menggunakan ["Bug Report" template](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Masalah keamanan**: Laporkan secara pribadi melalui [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +- Buat bug baru menggunakan [template "Laporan Bug"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) dengan: + - Langkah-langkah reproduksi yang jelas dan bernomor + - Hasil yang diharapkan vs aktual + - Versi Roo Code (wajib); penyedia/model API jika relevan +- **Masalah keamanan**: Laporkan secara pribadi melalui [saran keamanan](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). -## Proses Pengembangan & Pengiriman +## Proses Pengembangan & Pengajuan -### Setup Pengembangan +### Pengaturan Pengembangan -1. **Fork & Clone:** +1. **Fork & Klon:** ``` -git clone https://github.com/YOUR_USERNAME/Roo-Code.git +git clone https://github.com/NAMA_PENGGUNA_ANDA/Roo-Code.git ``` -2. **Install Dependencies:** +2. **Instal Ketergantungan:** ``` pnpm install @@ -106,33 +108,34 @@ pnpm install 3. **Debugging:** Buka dengan VS Code (`F5`). -### Panduan Menulis Kode +### Pedoman Menulis Kode -- Satu PR yang fokus per fitur atau perbaikan. +- Satu PR terfokus per fitur atau perbaikan. - Ikuti praktik terbaik ESLint dan TypeScript. -- Tulis commit yang jelas dan deskriptif yang merujuk pada isu (misalnya, `Fixes #123`). +- Tulis komitmen yang jelas dan deskriptif yang merujuk pada masalah (mis., `Memperbaiki #123`). - Sediakan pengujian menyeluruh (`npm test`). -- Rebase ke branch `main` terbaru sebelum pengiriman. +- Rebase ke cabang `main` terbaru sebelum pengajuan. -### Mengirimkan Pull Request +### Mengajukan Pull Request -- Mulai sebagai **Draft PR** jika mencari feedback awal. -- Jelaskan perubahan kamu dengan jelas mengikuti Template Pull Request. -- Sediakan screenshot/video untuk perubahan UI. +- Mulailah sebagai **PR Draf** jika mencari umpan balik awal. +- Jelaskan perubahan Anda dengan jelas mengikuti Templat Pull Request. +- Tautkan masalah di deskripsi/judul PR (mis., "Memperbaiki #123"). +- Sediakan tangkapan layar/video untuk perubahan UI. - Tunjukkan jika pembaruan dokumentasi diperlukan. ### Kebijakan Pull Request -- Harus merujuk pada isu yang telah disetujui dan ditugaskan sebelumnya. -- PR tanpa kepatuhan terhadap kebijakan dapat ditutup. +- Harus merujuk pada Masalah GitHub yang ditugaskan. Untuk ditugaskan: beri komentar "Mengklaim" pada masalah tersebut dan kirim DM ke **Hannes Rudolph (`hrudolph`)** di [Discord](https://discord.gg/roocode). Penugasan akan dikonfirmasi di utas. +- PR yang tidak tertaut dapat ditutup. - PR harus lulus tes CI, selaras dengan peta jalan, dan memiliki dokumentasi yang jelas. -### Proses Review +### Proses Peninjauan -- **Triage Harian:** Pemeriksaan cepat oleh maintainer. -- **Review Mendalam Mingguan:** Penilaian komprehensif. -- **Iterasi segera** berdasarkan feedback. +- **Triase Harian:** Pemeriksaan cepat oleh pengelola. +- **Tinjauan Mendalam Mingguan:** Penilaian komprehensif. +- **Iterasi dengan cepat** berdasarkan umpan balik. -## Legal +## Hukum -Dengan berkontribusi, kamu setuju kontribusi kamu akan dilisensikan di bawah Lisensi Apache 2.0, konsisten dengan lisensi Roo Code. +Dengan berkontribusi, Anda setuju bahwa kontribusi Anda akan dilisensikan di bawah Lisensi Apache 2.0, sesuai dengan lisensi Roo Code. diff --git a/locales/it/CONTRIBUTING.md b/locales/it/CONTRIBUTING.md index ccb48801e39..65e9fcc2af7 100644 --- a/locales/it/CONTRIBUTING.md +++ b/locales/it/CONTRIBUTING.md @@ -13,9 +13,9 @@ # Contribuire a Roo Code -Roo Code è un progetto guidato dalla community e apprezziamo molto ogni contributo. Per semplificare la collaborazione, operiamo secondo un approccio [Issue-First](#approccio-issue-first), il che significa che tutte le [Pull Request (PR)](#inviare-una-pull-request) devono prima essere collegate a una Issue GitHub. Ti preghiamo di leggere attentamente questa guida. +Roo Code è un progetto guidato dalla comunità e apprezziamo profondamente ogni contributo. Per semplificare la collaborazione, operiamo su una base [Issue-First](#approccio-issue-first), il che significa che tutte le [Pull Request (PR)](#invio-di-una-pull-request) devono prima essere collegate a un'issue di GitHub. Si prega di leggere attentamente questa guida. -## Indice +## Sommario - [Prima di contribuire](#prima-di-contribuire) - [Trovare e pianificare il tuo contributo](#trovare-e-pianificare-il-tuo-contributo) @@ -26,113 +26,116 @@ Roo Code è un progetto guidato dalla community e apprezziamo molto ogni contrib ### 1. Codice di condotta -Tutti i collaboratori devono rispettare il nostro [Codice di condotta](./CODE_OF_CONDUCT.md). +Tutti i contributori devono attenersi al nostro [Codice di condotta](./CODE_OF_CONDUCT.md). ### 2. Roadmap del progetto -La nostra roadmap guida la direzione del progetto. Allinea i tuoi contributi con questi obiettivi chiave: +La nostra roadmap guida la direzione del progetto. Allinea i tuoi contributi a questi obiettivi chiave: ### Affidabilità prima di tutto -- Garantire che l'editing delle differenze e l'esecuzione dei comandi siano costantemente affidabili -- Ridurre i punti di attrito che scoraggiano l'uso regolare -- Garantire un funzionamento fluido in tutte le lingue e su tutte le piattaforme -- Ampliare il supporto robusto per una vasta gamma di provider e modelli di IA +- Assicurati che la modifica dei diff e l'esecuzione dei comandi siano costantemente affidabili. +- Riduci i punti di frizione che scoraggiano l'uso regolare. +- Garantisci un funzionamento fluido in tutte le localizzazioni e piattaforme. +- Espandi un supporto solido per un'ampia varietà di provider e modelli di intelligenza artificiale. ### Esperienza utente migliorata -- Semplificare l'interfaccia utente per maggiore chiarezza e intuitività -- Migliorare continuamente il flusso di lavoro per soddisfare le elevate aspettative degli sviluppatori +- Semplifica l'interfaccia utente/esperienza utente per chiarezza e intuitività. +- Migliora continuamente il flusso di lavoro per soddisfare le elevate aspettative che gli sviluppatori hanno per gli strumenti di uso quotidiano. -### Leadership nelle prestazioni degli agenti +### Leader nelle prestazioni degli agenti -- Stabilire parametri di valutazione completi (evals) per misurare la produttività nel mondo reale -- Rendere facile per tutti eseguire e interpretare queste valutazioni -- Fornire miglioramenti che dimostrino chiari aumenti nei punteggi di valutazione +- Stabilisci benchmark di valutazione completi (eval) per misurare la produttività nel mondo reale. +- Semplifica per tutti l'esecuzione e l'interpretazione di queste valutazioni. +- Fornisci miglioramenti che dimostrino chiari aumenti nei punteggi di valutazione. Menziona l'allineamento con queste aree nelle tue PR. -### 3. Unisciti alla community Roo Code +### 3. Unisciti alla community di Roo Code - **Principale:** Unisciti al nostro [Discord](https://discord.gg/roocode) e invia un DM a **Hannes Rudolph (`hrudolph`)**. -- **Alternativa:** I collaboratori esperti possono partecipare direttamente tramite [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). +- **Alternativa:** I contributori esperti possono interagire direttamente tramite i [progetti GitHub](https://github.com/orgs/RooCodeInc/projects/1). ## Trovare e pianificare il tuo contributo ### Tipi di contributi -- **Correzione bug:** Risolvere problemi nel codice. -- **Nuove funzionalità:** Aggiungere nuove funzionalità. -- **Documentazione:** Migliorare guide e chiarezza. +- **Correzioni di bug:** risoluzione di problemi di codice. +- **Nuove funzionalità:** aggiunta di funzionalità. +- **Documentazione:** miglioramento di guide e chiarezza. ### Approccio Issue-First -Tutti i contributi devono iniziare con una Issue GitHub. +Tutti i contributi iniziano con un'issue di GitHub utilizzando i nostri modelli snelli. -- **Verificare le issue esistenti:** Cerca su [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Creare una issue:** Usa i template appropriati: - - **Bug:** Template "Bug Report". - - **Funzionalità:** Template "Detailed Feature Proposal". Approvazione richiesta prima di iniziare. -- **Reclamare issue:** Commenta e attendi l'assegnazione ufficiale. - -**Le PR senza issue approvate potrebbero essere chiuse.** +- **Controlla le issue esistenti**: cerca nelle [issue di GitHub](https://github.com/RooCodeInc/Roo-Code/issues). +- **Crea un'issue** utilizzando: + - **Miglioramenti:** modello "Richiesta di miglioramento" (linguaggio semplice incentrato sul vantaggio per l'utente). + - **Bug:** modello "Segnalazione di bug" (riproduzione minima + previsto vs effettivo + versione). +- **Vuoi lavorarci?** Commenta "Rivendico" sull'issue e invia un DM a **Hannes Rudolph (`hrudolph`)** su [Discord](https://discord.gg/roocode) per essere assegnato. L'assegnazione verrà confermata nel thread. +- **Le PR devono essere collegate all'issue.** Le PR non collegate possono essere chiuse. ### Decidere su cosa lavorare -- Controlla il [Progetto GitHub](https://github.com/orgs/RooCodeInc/projects/1) per "Good First Issues" non assegnate. +- Controlla il [progetto GitHub](https://github.com/orgs/RooCodeInc/projects/1) per le issue "Issue [Non assegnata]". - Per la documentazione, visita [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). -### Segnalare bug +### Segnalazione di bug -- Controlla prima i report esistenti. -- Crea nuovi report di bug usando il [template "Bug Report"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Problemi di sicurezza:** Segnala privatamente tramite [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +- Controlla prima le segnalazioni esistenti. +- Crea un nuovo bug utilizzando il [modello "Segnalazione di bug"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) con: + - Passaggi di riproduzione chiari e numerati + - Risultato previsto vs effettivo + - Versione di Roo Code (obbligatoria); provider/modello di intelligenza artificiale se pertinente +- **Problemi di sicurezza**: segnala in privato tramite [avvisi di sicurezza](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). ## Processo di sviluppo e invio ### Configurazione dello sviluppo -1. **Fork & Clona:** +1. **Esegui il fork e clona:** ``` -git clone https://github.com/TUO_USERNAME/Roo-Code.git +git clone https://github.com/TUO_NOME_UTENTE/Roo-Code.git ``` 2. **Installa le dipendenze:** ``` -npm run install:all +pnpm install ``` -3. **Debug:** Apri con VS Code (`F5`). +3. **Debug:** apri con VS Code (`F5`). -### Linee guida per scrivere codice +### Linee guida per la scrittura del codice -- Una PR focalizzata per funzionalità o correzione. -- Segui le best practice di ESLint e TypeScript. -- Scrivi commit chiari e descrittivi che fanno riferimento alle issue (es. `Fixes #123`). +- Una PR mirata per funzionalità o correzione. +- Segui le migliori pratiche di ESLint e TypeScript. +- Scrivi commit chiari e descrittivi che facciano riferimento alle issue (ad es. `Risolve #123`). - Fornisci test approfonditi (`npm test`). -- Fai rebase sul branch `main` più recente prima dell'invio. +- Esegui il rebase sul ramo `main` più recente prima dell'invio. -### Inviare una Pull Request +### Invio di una Pull Request -- Inizia come **PR in bozza** se cerchi feedback anticipato. -- Descrivi chiaramente le tue modifiche seguendo il Template di Pull Request. -- Fornisci screenshot/video per modifiche UI. +- Inizia come **bozza di PR** se cerchi un feedback iniziale. +- Descrivi chiaramente le tue modifiche seguendo il modello di Pull Request. +- Collega l'issue nella descrizione/titolo della PR (ad es. "Risolve #123"). +- Fornisci screenshot/video per le modifiche all'interfaccia utente. - Indica se sono necessari aggiornamenti alla documentazione. -### Politica di Pull Request +### Politica sulle Pull Request -- Deve fare riferimento a issue pre-approvate e assegnate. -- Le PR che non rispettano la politica potrebbero essere chiuse. -- Le PR dovrebbero superare i test CI, allinearsi con la roadmap e avere documentazione chiara. +- Deve fare riferimento a un'issue di GitHub assegnata. Per essere assegnato: commenta "Rivendico" sull'issue e invia un DM a **Hannes Rudolph (`hrudolph`)** su [Discord](https://discord.gg/roocode). L'assegnazione verrà confermata nel thread. +- Le PR non collegate possono essere chiuse. +- Le PR devono superare i test di integrazione continua, essere in linea con la roadmap e avere una documentazione chiara. ### Processo di revisione -- **Triage quotidiano:** Controlli rapidi da parte dei maintainer. -- **Revisione settimanale approfondita:** Valutazione completa. -- **Itera rapidamente** in base al feedback. +- **Triage giornaliero:** controlli rapidi da parte dei manutentori. +- **Revisione approfondita settimanale:** valutazione completa. +- **Itera prontamente** in base al feedback. ## Legale -Inviando una pull request, accetti che i tuoi contributi siano concessi in licenza sotto la Licenza Apache 2.0, in linea con la licenza di Roo Code. +Contribuendo, accetti che i tuoi contributi siano concessi in licenza con la licenza Apache 2.0, in coerenza con la licenza di Roo Code. diff --git a/locales/ja/CONTRIBUTING.md b/locales/ja/CONTRIBUTING.md index a1fb5db53b6..168c7b4d16c 100644 --- a/locales/ja/CONTRIBUTING.md +++ b/locales/ja/CONTRIBUTING.md @@ -11,88 +11,90 @@ -# Roo Code への貢献 +# Roo Codeへの貢献 -Roo Code はコミュニティ主導のプロジェクトであり、すべての貢献を大切にしています。協力をスムーズにするため、[Issue-First](#issue-first-アプローチ)方式を採用しています。これはすべての[Pull Request (PR)](#pull-request-の提出)がまずGitHub Issueに紐付けられる必要があることを意味します。このガイドをよく読んでください。 +Roo Codeはコミュニティ主導のプロジェクトであり、すべての貢献を深く評価しています。共同作業を円滑にするため、私たちは[課題第一のアプローチ](#課題第一のアプローチ)で運営しています。つまり、すべての[プルリクエスト（PR）](#プルリクエストの提出)は、まずGitHubの課題にリンクされている必要があります。このガイドを注意深く確認してください。 ## 目次 - [貢献する前に](#貢献する前に) -- [貢献内容の発見と計画](#貢献内容の発見と計画) +- [貢献内容の検索と計画](#貢献内容の検索と計画) - [開発と提出のプロセス](#開発と提出のプロセス) -- [法的事項](#法的事項) +- [法務](#法務) ## 貢献する前に ### 1. 行動規範 -すべてのコントリビューターは[行動規範](./CODE_OF_CONDUCT.md)を守る必要があります。 +すべての貢献者は、私たちの[行動規範](./CODE_OF_CONDUCT.md)に従う必要があります。 -### 2. プロジェクトロードマップ +### 2. プロジェクトのロードマップ -ロードマップはプロジェクトの方向性を示します。貢献をこれらの主要目標に沿わせてください： +私たちのロードマップは、プロジェクトの方向性を示しています。あなたの貢献をこれらの主要な目標に合わせてください。 -### 信頼性優先 +### 信頼性第一 -- diff編集とコマンド実行が常に信頼できることを保証 -- 定期的な使用を妨げる摩擦ポイントの削減 -- すべての言語環境とプラットフォームでのスムーズな動作を保証 -- 様々なAIプロバイダーとモデルへの堅牢なサポートを拡大 +- 差分編集とコマンド実行が一貫して信頼できることを確認します。 +- 定期的な使用を妨げる摩擦点を減らします。 +- すべてのロケールとプラットフォームでスムーズな操作を保証します。 +- さまざまなAIプロバイダーとモデルに対する堅牢なサポートを拡大します。 -### ユーザー体験の強化 +### ユーザーエクスペリエンスの向上 -- 明確さと直感性のためのUI/UXの合理化 -- 開発者が日常的に使用するツールに求める高い期待に応えるためのワークフローの継続的改善 +- 明確さと直感性のためにUI/UXを合理化します。 +- 開発者が日常的に使用するツールに期待する高い期待に応えるために、ワークフローを継続的に改善します。 -### エージェントパフォーマンスの先導 +### エージェントパフォーマンスのリード -- 実際の生産性を測定する包括的な評価基準（evals）の確立 -- 誰もが簡単にこれらの評価を実行して解釈できるようにする -- 評価スコアの明確な向上を示す改善を提供 +- 現実世界の生産性を測定するための包括的な評価ベンチマーク（evals）を確立します。 +- 誰もがこれらの評価を簡単に実行および解釈できるようにします。 +- 評価スコアの明確な増加を示す改善を出荷します。 -PRでこれらの領域との関連性に言及してください。 +PRでこれらの分野との連携について言及してください。 -### 3. Roo Code コミュニティに参加する +### 3. Roo Codeコミュニティに参加する -- **主な方法：** [Discord](https://discord.gg/roocode)に参加し、**Hannes Rudolph (`hrudolph`)**にDMを送る。 -- **代替手段：** 経験豊富なコントリビューターは[GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1)を通じて直接参加できます。 +- **プライマリ：** [Discord](https://discord.gg/roocode)に参加し、**Hannes Rudolph (`hrudolph`)**にDMしてください。 +- **代替：** 経験豊富な貢献者は、[GitHubプロジェクト](https://github.com/orgs/RooCodeInc/projects/1)を介して直接関与できます。 -## 貢献内容の発見と計画 +## 貢献内容の検索と計画 ### 貢献の種類 -- **バグ修正：** コードの問題を解決。 -- **新機能：** 機能を追加。 -- **ドキュメント：** ガイドを改善し明確にする。 +- **バグ修正：** コードの問題への対処。 +- **新機能：** 機能の追加。 +- **ドキュメント：** ガイドと明確さの向上。 -### Issue-First アプローチ +### 課題第一のアプローチ -すべての貢献はGitHub Issueから始めてください。 +すべての貢献は、私たちのスキニーテンプレートを使用してGitHubの課題から始まります。 -- **既存Issueの確認：** [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)を検索。 -- **Issueの作成：** 適切なテンプレートを使用： - - **バグ：** 「Bug Report」テンプレート。 - - **機能：** 「Detailed Feature Proposal」テンプレート。開始前に承認が必要。 -- **Issue担当表明：** コメントし、正式な割り当てを待つ。 +- **既存の課題を確認する**：[GitHubの課題](https://github.com/RooCodeInc/Roo-Code/issues)で検索します。 +- **課題を作成する**： + - **機能強化：** 「機能強化リクエスト」テンプレート（ユーザーの利益に焦点を当てた平易な言葉）。 + - **バグ：** 「バグレポート」テンプレート（最小限の再現+期待値と実際値+バージョン）。 +- **それに取り組みたいですか？** 課題に「Claiming」とコメントし、[Discord](https://discord.gg/roocode)で**Hannes Rudolph（`hrudolph`）**にDMして割り当てを受けてください。割り当てはスレッドで確認されます。 +- **PRは課題にリンクする必要があります。** リンクされていないPRはクローズされる場合があります。 -**承認されたIssueに紐付けられていないPRは閉じられる可能性があります。** +### 何に取り組むかを決める -### 何に取り組むか決める - -- 未割り当ての「Good First Issues」を[GitHub Project](https://github.com/orgs/RooCodeInc/projects/1)でチェック。 -- ドキュメント関連は[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のバージョン（必須）。関連する場合はAPIプロバイダー/モデル +- **セキュリティの問題**：[セキュリティアドバイザリ](https://github.com/RooCodeInc/Roo-Code/security/advisories/new)を介して非公開で報告してください。 ## 開発と提出のプロセス -### 開発環境のセットアップ +### 開発のセットアップ -1. **Fork & Clone：** +1. **フォークとクローン：** ``` git clone https://github.com/あなたのユーザー名/Roo-Code.git @@ -101,38 +103,39 @@ git clone https://github.com/あなたのユーザー名/Roo-Code.git 2. **依存関係のインストール：** ``` -npm run install:all +pnpm install ``` -3. **デバッグ：** VS Codeで`F5`を押して開く。 +3. **デバッグ：** VS Codeで開きます（`F5`）。 -### コーディングガイドライン +### コーディングのガイドライン -- 1つの機能または修正ごとに1つのPR。 -- ESLintとTypeScriptのベストプラクティスに従う。 -- 関連Issueを参照する明確なコミットメッセージを書く（例：`Fixes #123`）。 -- 十分なテストを提供（`npm test`）。 -- 提出前に最新の`main`ブランチにリベース。 +- 機能または修正ごとに1つの焦点を絞ったPR。 +- ESLintとTypeScriptのベストプラクティスに従ってください。 +- 課題を参照する明確で説明的なコミットを作成します（例：`Fixes #123`）。 +- 徹底的なテストを提供します（`npm test`）。 +- 提出前に最新の`main`ブランチにリベースします。 -### Pull Request の提出 +### プルリクエストの提出 -- 早期フィードバックを求める場合は**ドラフトPR**から始める。 -- Pull Requestテンプレートに従って変更を明確に説明。 -- UI変更のスクリーンショット/動画を提供。 -- ドキュメント更新が必要かどうかを示す。 +- 早期のフィードバックを求める場合は、**ドラフトPR**として開始します。 +- プルリクエストテンプレートに従って、変更内容を明確に説明します。 +- PRの説明/タイトルに課題をリンクします（例：「Fixes #123」）。 +- UIの変更については、スクリーンショット/ビデオを提供します。 +- ドキュメントの更新が必要かどうかを示します。 -### Pull Request ポリシー +### プルリクエストポリシー -- 承認・割り当て済みIssueを参照する必要がある。 -- ポリシーに従わないPRは閉じられる可能性がある。 -- PRはCIテストに合格し、ロードマップに沿い、明確なドキュメントを持つべき。 +- 割り当てられたGitHubの課題を参照する必要があります。割り当てを受けるには、課題に「Claiming」とコメントし、[Discord](https://discord.gg/roocode)で**Hannes Rudolph（`hrudolph`）**にDMしてください。割り当てはスレッドで確認されます。 +- リンクされていないPRはクローズされる場合があります。 +- PRはCIテストに合格し、ロードマップに沿っており、明確なドキュメントが必要です。 ### レビュープロセス -- **日次トリアージ：** メンテナーによる迅速なチェック。 -- **週次詳細レビュー：** 包括的な評価。 -- **フィードバックに基づいて迅速に改善**。 +- **毎日のトリアージ：** メンテナーによる簡単なチェック。 +- **毎週の詳細なレビュー：** 包括的な評価。 +- フィードバックに基づいて**迅速に反復**します。 -## 法的事項 +## 法務 -Pull Requestを提出することで、あなたの貢献がRoo Codeと同じApache 2.0ライセンスの下で提供されることに同意したことになります。 +貢献することにより、あなたの貢献がRoo Codeのライセンスと一致するApache 2.0ライセンスの下でライセンスされることに同意したことになります。 diff --git a/locales/ko/CONTRIBUTING.md b/locales/ko/CONTRIBUTING.md index 6b3b8c293ca..8ef981d7eba 100644 --- a/locales/ko/CONTRIBUTING.md +++ b/locales/ko/CONTRIBUTING.md @@ -11,18 +11,18 @@ -# Roo Code 기여 가이드 +# Roo Code에 기여하기 -Roo Code는 커뮤니티 주도의 프로젝트이며, 모든 기여를 소중하게 생각합니다. 협업을 간소화하기 위해 [Issue-First](#issue-first-접근법) 원칙을 적용하고 있으며, 이는 모든 [Pull Request (PR)](#pull-request-제출)가 먼저 GitHub Issue와 연결되어야 함을 의미합니다. 이 가이드를 주의 깊게 검토해 주세요. +Roo Code는 커뮤니티 기반 프로젝트이며 모든 기여를 소중하게 생각합니다. 협업을 간소화하기 위해 [이슈 우선 접근 방식](#이슈-우선-접근-방식)으로 운영됩니다. 즉, 모든 [풀 리퀘스트(PR)](#풀-리퀘스트-제출)는 먼저 GitHub 이슈에 연결되어야 합니다. 이 가이드를 주의 깊게 검토해 주세요. ## 목차 -- [기여 전 준비](#기여-전-준비) -- [기여 내용 찾기 및 계획 세우기](#기여-내용-찾기-및-계획-세우기) -- [개발 및 제출 프로세스](#개발-및-제출-프로세스) -- [법적 안내](#법적-안내) +- [기여하기 전에](#기여하기-전에) +- [기여 찾기 및 계획하기](#기여-찾기-및-계획하기) +- [개발 및 제출 절차](#개발-및-제출-절차) +- [법률](#법률) -## 기여 전 준비 +## 기여하기 전에 ### 1. 행동 강령 @@ -30,109 +30,112 @@ Roo Code는 커뮤니티 주도의 프로젝트이며, 모든 기여를 소중 ### 2. 프로젝트 로드맵 -로드맵은 프로젝트 방향을 안내합니다. 기여를 다음 핵심 목표에 맞추세요: +로드맵은 프로젝트의 방향을 안내합니다. 기여를 다음 주요 목표에 맞게 조정하세요. -### 신뢰성 우선 +### 안정성 우선 -- diff 편집과 명령 실행의 일관된 신뢰성 보장 -- 정기적 사용을 방해하는 마찰점 감소 -- 모든 언어 환경과 플랫폼에서의 원활한 작동 보장 -- 다양한 AI 제공업체 및 모델에 대한 강력한 지원 확대 +- diff 편집 및 명령어 실행이 일관되게 안정적인지 확인합니다. +- 정기적인 사용을 방해하는 마찰 지점을 줄입니다. +- 모든 로케일 및 플랫폼에서 원활한 작동을 보장합니다. +- 다양한 AI 제공업체 및 모델에 대한 강력한 지원을 확대합니다. ### 향상된 사용자 경험 -- 명확성과 직관성을 위한 UI/UX 간소화 -- 개발자들이 일상적으로 사용하는 도구에 기대하는 높은 기준을 충족하기 위한 지속적인 워크플로우 개선 +- 명확하고 직관적인 UI/UX를 위해 간소화합니다. +- 개발자가 매일 사용하는 도구에 대해 기대하는 높은 수준을 충족하도록 워크플로를 지속적으로 개선합니다. ### 에이전트 성능 선도 -- 실제 생산성을 측정하는 포괄적인 평가 기준(evals) 수립 -- 누구나 이러한 평가를 쉽게 실행하고 해석할 수 있도록 지원 -- 평가 점수의 명확한 향상을 보여주는 개선 제공 +- 실제 생산성을 측정하기 위한 포괄적인 평가 벤치마크(evals)를 수립합니다. +- 누구나 이러한 평가를 쉽게 실행하고 해석할 수 있도록 합니다. +- 평가 점수의 명확한 증가를 보여주는 개선 사항을 제공합니다. -PR에서 이러한 영역과의 연관성을 언급하세요. +PR에 이러한 영역과의 연관성을 언급하세요. -### 3. Roo Code 커뮤니티 참여 +### 3. Roo Code 커뮤니티에 참여하세요 -- **주요 방법:** [Discord](https://discord.gg/roocode)에 가입하고 **Hannes Rudolph (`hrudolph`)**에게 DM을 보내세요. -- **대안:** 경험 많은 기여자는 [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1)를 통해 직접 참여할 수 있습니다. +- **기본:** [Discord](https://discord.gg/roocode)에 참여하여 **Hannes Rudolph (`hrudolph`)**에게 DM을 보내세요. +- **대안:** 숙련된 기여자는 [GitHub 프로젝트](https://github.com/orgs/RooCodeInc/projects/1)를 통해 직접 참여할 수 있습니다. -## 기여 내용 찾기 및 계획 세우기 +## 기여 찾기 및 계획하기 ### 기여 유형 - **버그 수정:** 코드 문제 해결. -- **새 기능:** 기능 추가. -- **문서화:** 가이드 개선 및 명확성 향상. +- **새로운 기능:** 기능 추가. +- **문서:** 가이드 및 명확성 향상. -### Issue-First 접근법 +### 이슈 우선 접근 방식 -모든 기여는 GitHub Issue에서 시작해야 합니다. +모든 기여는 간소화된 템플릿을 사용하여 GitHub 이슈에서 시작됩니다. -- **기존 Issue 확인:** [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)를 검색하세요. -- **Issue 생성:** 적절한 템플릿 사용: - - **버그:** "Bug Report" 템플릿. - - **기능:** "Detailed Feature Proposal" 템플릿. 시작 전 승인 필요. -- **Issue 담당:** 댓글을 달고 공식 할당을 기다리세요. +- **기존 이슈 확인**: [GitHub 이슈](https://github.com/RooCodeInc/Roo-Code/issues)에서 검색합니다. +- **이슈 생성**: + - **개선 사항:** "개선 요청" 템플릿 (사용자 혜택에 초점을 맞춘 평이한 언어). + - **버그:** "버그 보고" 템플릿 (최소한의 재현 + 예상 대 실제 + 버전). +- **작업하고 싶으신가요?** 이슈에 "Claiming"이라고 댓글을 달고 [Discord](https://discord.gg/roocode)에서 **Hannes Rudolph (`hrudolph`)**에게 DM을 보내 할당을 받으세요. 할당은 스레드에서 확인됩니다. +- **PR은 이슈에 연결되어야 합니다.** 연결되지 않은 PR은 종료될 수 있습니다. -**승인된 Issue 없는 PR은 닫힐 수 있습니다.** +### 작업할 내용 결정하기 -### 작업 선택하기 +- "이슈 [할당되지 않음]" 이슈는 [GitHub 프로젝트](https://github.com/orgs/RooCodeInc/projects/1)를 확인하세요. +- 문서는 [Roo Code 문서](https://github.com/RooCodeInc/Roo-Code-Docs)를 방문하세요. -- 할당되지 않은 "Good First Issues"를 [GitHub 프로젝트](https://github.com/orgs/RooCodeInc/projects/1)에서 확인하세요. -- 문서 관련은 [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs)를 참조하세요. +### 버그 신고하기 -### 버그 신고 +- 먼저 기존 보고서가 있는지 확인하세요. +- ["버그 보고" 템플릿](https://github.com/RooCodeInc/Roo-Code/issues/new/choose)을 사용하여 새 버그를 생성하세요. + - 명확하고 번호가 매겨진 재현 단계 + - 예상 결과 대 실제 결과 + - Roo Code 버전 (필수), 관련이 있는 경우 API 제공업체/모델 +- **보안 문제**: [보안 권고](https://github.com/RooCodeInc/Roo-Code/security/advisories/new)를 통해 비공개로 보고하세요. -- 먼저 기존 신고를 확인하세요. -- ["Bug Report" 템플릿](https://github.com/RooCodeInc/Roo-Code/issues/new/choose)을 사용하여 새 버그를 신고하세요. -- **보안 문제:** [security advisories](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. **의존성 설치:** ``` -npm run install:all +pnpm install ``` -3. **디버깅:** VS Code에서 `F5`를 눌러 실행하세요. +3. **디버깅:** VS Code로 엽니다 (`F5`). ### 코드 작성 가이드라인 -- 하나의 기능 또는 수정당 하나의 집중된 PR. -- ESLint와 TypeScript 모범 사례를 따르세요. -- Issue를 참조하는 명확한 커밋 메시지를 작성하세요(예: `Fixes #123`). -- 철저한 테스트를 제공하세요(`npm test`). -- 제출 전 최신 `main` 브랜치에 리베이스하세요. +- 기능 또는 수정당 하나의 집중된 PR. +- ESLint 및 TypeScript 모범 사례를 따릅니다. +- 이슈를 참조하는 명확하고 설명적인 커밋을 작성합니다 (예: `Fixes #123`). +- 철저한 테스트를 제공합니다 (`npm test`). +- 제출하기 전에 최신 `main` 브랜치로 리베이스합니다. -### Pull Request 제출 +### 풀 리퀘스트 제출 -- 초기 피드백을 원한다면 **드래프트 PR**로 시작하세요. -- Pull Request 템플릿에 따라 변경 사항을 명확히 설명하세요. -- UI 변경에 대한 스크린샷/동영상을 제공하세요. +- 초기 피드백을 원하면 **초안 PR**로 시작하세요. +- 풀 리퀘스트 템플릿에 따라 변경 사항을 명확하게 설명하세요. +- PR 설명/제목에 이슈를 연결하세요 (예: "Fixes #123"). +- UI 변경 사항에 대한 스크린샷/동영상을 제공하세요. - 문서 업데이트가 필요한지 표시하세요. -### Pull Request 정책 +### 풀 리퀘스트 정책 -- 사전 승인 및 할당된 Issue를 참조해야 합니다. -- 정책을 준수하지 않는 PR은 닫힐 수 있습니다. -- PR은 CI 테스트를 통과하고, 로드맵에 부합하며, 명확한 문서를 갖추어야 합니다. +- 할당된 GitHub 이슈를 참조해야 합니다. 할당을 받으려면: 이슈에 "Claiming"이라고 댓글을 달고 [Discord](https://discord.gg/roocode)에서 **Hannes Rudolph (`hrudolph`)**에게 DM을 보내세요. 할당은 스레드에서 확인됩니다. +- 연결되지 않은 PR은 종료될 수 있습니다. +- PR은 CI 테스트를 통과하고 로드맵과 일치하며 명확한 문서를 포함해야 합니다. -### 리뷰 프로세스 +### 검토 절차 -- **일일 분류:** 메인테이너의 빠른 검토. -- **주간 심층 리뷰:** 종합적인 평가. -- **피드백에 따라 신속히 반복**하세요. +- **매일 분류:** 유지 관리자의 빠른 확인. +- **매주 심층 검토:** 포괄적인 평가. +- 피드백을 바탕으로 **신속하게 반복**합니다. -## 법적 안내 +## 법률 -기여함으로써, 귀하의 기여가 Roo Code의 라이선스와 일치하는 Apache 2.0 라이선스 하에 제공됨에 동의합니다. +기여함으로써 귀하는 귀하의 기여가 Roo Code의 라이선스와 일치하는 Apache 2.0 라이선스에 따라 라이선스가 부여된다는 데 동의합니다. diff --git a/locales/nl/CONTRIBUTING.md b/locales/nl/CONTRIBUTING.md index 6f8c9d0e69d..719b61fc997 100644 --- a/locales/nl/CONTRIBUTING.md +++ b/locales/nl/CONTRIBUTING.md @@ -13,13 +13,13 @@ # Bijdragen aan Roo Code -Roo Code is een door de community gedreven project en we waarderen elke bijdrage enorm. Om de samenwerking te stroomlijnen, werken we volgens een [Issue-First](#issue-first-aanpak) principe, wat betekent dat alle [Pull Requests (PR's)](#een-pull-request-indienen) eerst gekoppeld moeten worden aan een GitHub Issue. Lees deze gids zorgvuldig door. +Roo Code is een door de gemeenschap gedreven project en we waarderen elke bijdrage ten zeerste. Om de samenwerking te stroomlijnen, werken we op basis van een [Issue-First-aanpak](#issue-first-aanpak), wat betekent dat alle [Pull Requests (PR's)](#een-pull-request-indienen) eerst gekoppeld moeten zijn aan een GitHub Issue. Lees deze handleiding zorgvuldig door. ## Inhoudsopgave - [Voordat je bijdraagt](#voordat-je-bijdraagt) -- [Je bijdrage vinden & plannen](#je-bijdrage-vinden--plannen) -- [Ontwikkelings- & indieningsproces](#ontwikkelings--indieningsproces) +- [Je bijdrage vinden en plannen](#je-bijdrage-vinden-en-plannen) +- [Ontwikkelings- en indieningsproces](#ontwikkelings-en-indieningsproces) - [Juridisch](#juridisch) ## Voordat je bijdraagt @@ -28,111 +28,114 @@ Roo Code is een door de community gedreven project en we waarderen elke bijdrage Alle bijdragers moeten zich houden aan onze [Gedragscode](./CODE_OF_CONDUCT.md). -### 2. De project-roadmap +### 2. Projectroadmap -Onze roadmap bepaalt de richting van het project. Stem je bijdragen af op deze kernpunten: +Onze roadmap stuurt de richting van het project. Lijn je bijdragen uit met deze belangrijke doelen: -### Betrouwbaarheid eerst +### Betrouwbaarheid voorop -- Zorgen dat diff-bewerking en opdrachtuitvoering consistent betrouwbaar zijn -- Verminderen van wrijvingspunten die regelmatig gebruik ontmoedigen -- Garanderen van soepele werking in alle talen en op alle platforms -- Uitbreiden van robuuste ondersteuning voor een breed scala aan AI-providers en -modellen +- Zorg ervoor dat het bewerken van diffs en het uitvoeren van commando's consistent betrouwbaar zijn. +- Verminder wrijvingspunten die regelmatig gebruik ontmoedigen. +- Garandeer een soepele werking in alle locales en op alle platforms. +- Breid robuuste ondersteuning uit voor een breed scala aan AI-providers en -modellen. ### Verbeterde gebruikerservaring -- Vereenvoudigen van de gebruikersinterface voor meer duidelijkheid en intuïtiviteit -- Continu verbeteren van de workflow om te voldoen aan de hoge verwachtingen van ontwikkelaars +- Stroomlijn de UI/UX voor duidelijkheid en intuïtiviteit. +- Verbeter continu de workflow om te voldoen aan de hoge verwachtingen die ontwikkelaars hebben van dagelijks gebruikte tools. -### Voorop lopen in agent-prestaties +### Toonaangevend in prestaties van agenten -- Opstellen van uitgebreide evaluatiebenchmarks (evals) om productiviteit in de echte wereld te meten -- Het voor iedereen gemakkelijk maken om deze evaluaties uit te voeren en te interpreteren -- Verbeteringen leveren die duidelijke stijgingen in evaluatiescores aantonen +- Stel uitgebreide evaluatiebenchmarks (evals) op om de productiviteit in de praktijk te meten. +- Maak het voor iedereen gemakkelijk om deze evals uit te voeren en te interpreteren. +- Lever verbeteringen die duidelijke stijgingen in de eval-scores aantonen. Vermeld de afstemming met deze gebieden in je PR's. ### 3. Word lid van de Roo Code-community -- **Hoofdmethode:** Word lid van onze [Discord](https://discord.gg/roocode) en stuur een DM naar **Hannes Rudolph (`hrudolph`)**. -- **Alternatief:** Ervaren bijdragers kunnen direct meedoen via [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). +- **Primair:** Word lid van onze [Discord](https://discord.gg/roocode) en stuur een DM naar **Hannes Rudolph (`hrudolph`)**. +- **Alternatief:** Ervaren bijdragers kunnen rechtstreeks deelnemen via [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). -## Je bijdrage vinden & plannen +## Je bijdrage vinden en plannen ### Soorten bijdragen -- **Bugfixes:** Problemen in code oplossen. -- **Nieuwe functies:** Functionaliteit toevoegen. -- **Documentatie:** Handleidingen verbeteren en verduidelijken. +- **Bugfixes:** het aanpakken van codeproblemen. +- **Nieuwe functies:** het toevoegen van functionaliteit. +- **Documentatie:** het verbeteren van handleidingen en duidelijkheid. ### Issue-First-aanpak -Elke bijdrage moet beginnen met een GitHub Issue. +Alle bijdragen beginnen met een GitHub Issue met behulp van onze slanke sjablonen. -- **Bestaande issues controleren:** Zoek in [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Issue aanmaken:** Gebruik de juiste templates: - - **Bugs:** "Bug Report"-template. - - **Functies:** "Detailed Feature Proposal"-template. Goedkeuring vereist voor je begint. -- **Issues claimen:** Reageer en wacht op officiële toewijzing. +- **Controleer bestaande issues**: Zoek in [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). +- **Maak een issue** aan met: + - **Verbeteringen:** sjabloon "Verbeteringsverzoek" (eenvoudige taal gericht op gebruikersvoordeel). + - **Bugs:** sjabloon "Bugrapport" (minimale repro + verwacht vs. feitelijk + versie). +- **Wil je eraan werken?** Reageer met "Claiming" op de issue en stuur een DM naar **Hannes Rudolph (`hrudolph`)** op [Discord](https://discord.gg/roocode) om toegewezen te worden. De toewijzing wordt in de thread bevestigd. +- **PR's moeten naar de issue linken.** Niet-gekoppelde PR's kunnen worden gesloten. -**PR's zonder goedgekeurde issues kunnen worden gesloten.** +### Beslissen waaraan je wilt werken -### Bepalen waar je aan werkt +- Controleer het [GitHub Project](https://github.com/orgs/RooCodeInc/projects/1) voor "Issue [Niet-toegewezen]" issues. +- Ga voor documentatie naar [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). -- Bekijk het [GitHub Project](https://github.com/orgs/RooCodeInc/projects/1) voor niet-toegewezen "Good First Issues". -- Voor documentatie, bezoek [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). +### Bugs rapporteren -### Bugs of problemen melden +- Controleer eerst bestaande rapporten. +- Maak een nieuwe bug aan met het ["Bugrapport"-sjabloon](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) met: + - Duidelijke, genummerde reproductiestappen + - Verwacht vs. feitelijk resultaat + - Roo Code-versie (vereist); API-provider/model indien relevant +- **Beveiligingsproblemen**: Rapporteer privé via [beveiligingsadviezen](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). -- Controleer eerst of er al meldingen zijn. -- Maak nieuwe bugmeldingen met de ["Bug Report"-template](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Beveiligingsproblemen:** Meld privé via [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +## Ontwikkelings- en indieningsproces -## Ontwikkelings- & indieningsproces +### Ontwikkelingsopstelling -### Ontwikkelomgeving instellen - -1. **Fork & Clone:** +1. **Fork & Klonen:** ``` git clone https://github.com/JOUW_GEBRUIKERSNAAM/Roo-Code.git ``` -2. **Installeer afhankelijkheden:** +2. **Afhankelijkheden installeren:** ``` -npm run install:all +pnpm install ``` -3. **Debuggen:** Open met VS Code (`F5`). +3. **Debuggen:** Openen met VS Code (`F5`). ### Richtlijnen voor het schrijven van code - Eén gerichte PR per functie of fix. -- Volg ESLint en TypeScript best practices. +- Volg de best practices van ESLint en TypeScript. - Schrijf duidelijke, beschrijvende commits die verwijzen naar issues (bijv. `Fixes #123`). - Zorg voor grondige tests (`npm test`). -- Rebase op de nieuwste `main`-branch vóór indiening. +- Rebase naar de nieuwste `main`-tak vóór indiening. ### Een Pull Request indienen -- Begin als **concept-PR** als je vroege feedback zoekt. -- Beschrijf je wijzigingen duidelijk volgens de Pull Request Template. -- Voeg screenshots/video's toe voor UI-wijzigingen. +- Begin als een **Concept-PR** als je vroege feedback wilt. +- Beschrijf je wijzigingen duidelijk volgens het Pull Request-sjabloon. +- Koppel de issue in de PR-beschrijving/titel (bijv. "Fixes #123"). +- Zorg voor schermafbeeldingen/video's voor UI-wijzigingen. - Geef aan of documentatie-updates nodig zijn. -### Pull Request beleid +### Pull Request-beleid -- Moet verwijzen naar vooraf goedgekeurde en toegewezen issues. -- PR's die niet aan het beleid voldoen, kunnen worden gesloten. -- PR's moeten CI-tests doorstaan, aansluiten bij de roadmap en duidelijke documentatie hebben. +- Moet verwijzen naar een toegewezen GitHub Issue. Om toegewezen te worden: reageer met "Claiming" op de issue en stuur een DM naar **Hannes Rudolph (`hrudolph`)** op [Discord](https://discord.gg/roocode). De toewijzing wordt in de thread bevestigd. +- Niet-gekoppelde PR's kunnen worden gesloten. +- PR's moeten slagen voor CI-tests, in lijn zijn met de roadmap en duidelijke documentatie hebben. -### Reviewproces +### Beoordelingsproces -- **Dagelijkse triage:** Snelle controles door maintainers. -- **Wekelijkse diepgaande review:** Uitgebreide beoordeling. -- **Snel itereren** op basis van feedback. +- **Dagelijkse triage:** Snelle controles door onderhouders. +- **Wekelijkse diepgaande beoordeling:** Uitgebreide beoordeling. +- **Itereer snel** op basis van feedback. ## Juridisch -Door een pull request in te dienen, ga je ermee akkoord dat je bijdragen worden gelicenseerd onder de Apache 2.0-licentie, in overeenstemming met de licentie van Roo Code. +Door bij te dragen, ga je ermee akkoord dat je bijdragen onder de Apache 2.0-licentie worden gelicentieerd, in overeenstemming met de licentieverlening van Roo Code. diff --git a/locales/pl/CONTRIBUTING.md b/locales/pl/CONTRIBUTING.md index 16429647370..edc9581e48e 100644 --- a/locales/pl/CONTRIBUTING.md +++ b/locales/pl/CONTRIBUTING.md @@ -11,128 +11,131 @@ -# Współtworzenie Roo Code +# Wkład w Roo Code -Roo Code to projekt napędzany przez społeczność i bardzo cenimy każdy wkład. Aby usprawnić współpracę, działamy według zasady [Issue-First](#podejście-issue-first), co oznacza, że wszystkie [Pull Requesty (PR)](#zgłaszanie-pull-requesta) muszą najpierw być powiązane z GitHub Issue. Prosimy o uważne zapoznanie się z tym przewodnikiem. +Roo Code to projekt społecznościowy i głęboko cenimy każdy wkład. Aby usprawnić współpracę, działamy w oparciu o [podejście „najpierw zgłoszenie”](#podejście-najpierw-zgłoszenie), co oznacza, że wszystkie [żądania ściągnięcia (PR)](#przesyłanie-żądania-ściągnięcia) muszą być najpierw połączone ze zgłoszeniem na GitHubie. Prosimy o uważne zapoznanie się z tym przewodnikiem. ## Spis treści -- [Zanim zaczniesz współtworzyć](#zanim-zaczniesz-współtworzyć) +- [Zanim zaczniesz wnosić wkład](#zanim-zaczniesz-wnosić-wkład) - [Znajdowanie i planowanie swojego wkładu](#znajdowanie-i-planowanie-swojego-wkładu) -- [Proces rozwoju i zgłaszania](#proces-rozwoju-i-zgłaszania) -- [Prawne](#prawne) +- [Proces rozwoju i przesyłania](#proces-rozwoju-i-przesyłania) +- [Kwestie prawne](#kwestie-prawne) -## Zanim zaczniesz współtworzyć +## Zanim zaczniesz wnosić wkład ### 1. Kodeks postępowania Wszyscy współtwórcy muszą przestrzegać naszego [Kodeksu postępowania](./CODE_OF_CONDUCT.md). -### 2. Roadmapa projektu +### 2. Mapa drogowa projektu -Nasza roadmapa wyznacza kierunek projektu. Dostosuj swój wkład do tych kluczowych celów: +Nasza mapa drogowa wyznacza kierunek projektu. Dostosuj swój wkład do tych kluczowych celów: -### Niezawodność przede wszystkim +### Niezawodność na pierwszym miejscu -- Zapewnienie, że edycja różnic i wykonywanie poleceń są konsekwentnie niezawodne -- Zmniejszenie punktów tarcia, które zniechęcają do regularnego użytkowania -- Gwarancja płynnego działania we wszystkich językach i na wszystkich platformach -- Rozszerzenie solidnego wsparcia dla szerokiej gamy dostawców i modeli AI +- Zapewnij, że edycja różnic i wykonywanie poleceń są niezawodne. +- Zmniejsz punkty tarcia, które zniechęcają do regularnego użytkowania. +- Zagwarantuj płynne działanie we wszystkich lokalizacjach i na wszystkich platformach. +- Rozszerz solidne wsparcie для szerokiej gamy dostawców i modeli sztucznej inteligencji. -### Ulepszone doświadczenie użytkownika +### Ulepszone wrażenia użytkownika -- Uproszczenie interfejsu użytkownika dla większej przejrzystości i intuicyjności -- Ciągłe doskonalenie przepływu pracy, aby spełnić wysokie oczekiwania programistów +- Usprawnij interfejs użytkownika/doświadczenie użytkownika dla jasności i intuicyjności. +- Ciągle ulepszaj przepływ pracy, aby sprostać wysokim oczekiwaniom, jakie programiści mają wobec narzędzi codziennego użytku. -### Wiodąca pozycja w wydajności agentów +### Lider w wydajności agentów -- Ustanowienie kompleksowych punktów odniesienia (evals) do mierzenia produktywności w rzeczywistym świecie -- Ułatwienie wszystkim łatwego uruchamiania i interpretowania tych ocen -- Dostarczanie ulepszeń, które wykazują wyraźny wzrost wyników ocen +- Ustanów kompleksowe wzorce oceny (ewaluacje) w celu pomiaru rzeczywistej produktywności. +- Ułatw wszystkim łatwe uruchamianie i interpretowanie tych ewaluacji. +- Dostarczaj ulepszenia, które wykazują wyraźny wzrost wyników ewaluacji. -Wspomnij o powiązaniu z tymi obszarami w swoich PR. +Wspomnij o dostosowaniu do tych obszarów w swoich PR-ach. ### 3. Dołącz do społeczności Roo Code -- **Główna metoda:** Dołącz do naszego [Discorda](https://discord.gg/roocode) i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)**. -- **Alternatywa:** Doświadczeni współtwórcy mogą angażować się bezpośrednio przez [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). +- **Głównie:** Dołącz do naszego [Discorda](https://discord.gg/roocode) i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)**. +- **Alternatywa:** Doświadczeni współtwórcy mogą angażować się bezpośrednio za pośrednictwem [projektów na GitHubie](https://github.com/orgs/RooCodeInc/projects/1). ## Znajdowanie i planowanie swojego wkładu -### Typy wkładów +### Rodzaje wkładu -- **Poprawki błędów:** Naprawianie problemów w kodzie. -- **Nowe funkcje:** Dodawanie nowych funkcjonalności. -- **Dokumentacja:** Ulepszanie przewodników i zwiększanie przejrzystości. +- **Poprawki błędów:** rozwiązywanie problemów z kodem. +- **Nowe funkcje:** dodawanie funkcjonalności. +- **Dokumentacja:** ulepszanie przewodników i przejrzystości. -### Podejście Issue-First +### Podejście „najpierw zgłoszenie” -Każdy wkład musi zaczynać się od GitHub Issue. +Wszystkie wkłady zaczynają się od zgłoszenia na GitHubie przy użyciu naszych uproszczonych szablonów. -- **Sprawdź istniejące issues:** Przeszukaj [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Utwórz issue:** Używaj odpowiednich szablonów: - - **Błędy:** Szablon "Bug Report". - - **Funkcje:** Szablon "Detailed Feature Proposal". Wymagane zatwierdzenie przed rozpoczęciem. -- **Zgłoś chęć pracy:** Skomentuj i poczekaj na oficjalne przypisanie. - -**PR bez zatwierdzonego issue może zostać zamknięty.** +- **Sprawdź istniejące zgłoszenia**: Przeszukaj [zgłoszenia на GitHubie](https://github.com/RooCodeInc/Roo-Code/issues). +- **Utwórz zgłoszenie**, używając: + - **Ulepszenia:** szablon „Prośba o ulepszenie” (prosty język skoncentrowany na korzyściach dla użytkownika). + - **Błędy:** szablon „Zgłoszenie błędu” (minimalna reprodukcja + oczekiwane a rzeczywiste + wersja). +- **Chcesz nad tym popracować?** Skomentuj „Zgłaszam się” w zgłoszeniu i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)** na [Discordzie](https://discord.gg/roocode), aby zostać przypisanym. Przypisanie zostanie potwierdzone w wątku. +- **PR-y muszą być połączone зі zgłoszeniem.** Niepołączone PR-y mogą zostać zamknięte. ### Decydowanie, nad czym pracować -- Sprawdź [Projekt GitHub](https://github.com/orgs/RooCodeInc/projects/1) w poszukiwaniu nieprzypisanych "Good First Issues". -- W kwestii dokumentacji odwiedź [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). +- Sprawdź [projekt na GitHubie](https://github.com/orgs/RooCodeInc/projects/1) pod kątem zgłoszeń „Zgłoszenie [Nieprzypisane]”. +- Aby uzyskać dokumentację, odwiedź [dokumentację Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs). ### Zgłaszanie błędów -- Najpierw sprawdź istniejące zgłoszenia. -- Twórz nowe zgłoszenia błędów używając [szablonu "Bug Report"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Luki bezpieczeństwa:** Zgłaszaj prywatnie przez [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +- Najpierw sprawdź istniejące raporty. +- Utwórz nowy błąd, używając szablonu [„Zgłoszenie błędu”](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) z: + - Jasnymi, ponumerowanymi krokami reprodukcji + - Oczekiwanym a rzeczywistym wynikiem + - Wersją Roo Code (wymagane); dostawcą/modelem sztucznej inteligencji, jeśli ma to zastosowanie +- **Problemy z bezpieczeństwem**: Zgłoś je prywatnie za pośrednictwem [zaleceń dotyczących bezpieczeństwa](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). -## Proces rozwoju i zgłaszania +## Proces rozwoju i przesyłania -### Konfiguracja środowiska +### Konfiguracja środowiska programistycznego -1. **Fork & Clone:** +1. **Sforkuj i sklonuj:** ``` -git clone https://github.com/TWÓJ_UŻYTKOWNIK/Roo-Code.git +git clone https://github.com/TWOJA_NAZWA_UŻYTKOWNIKA/Roo-Code.git ``` -2. **Instalacja zależności:** +2. **Zainstaluj zależności:** ``` -npm run install:all +pnpm install ``` -3. **Debugowanie:** Otwórz w VS Code (`F5`). +3. **Debugowanie:** Otwórz za pomocą VS Code (`F5`). ### Wytyczne dotyczące pisania kodu - Jeden skoncentrowany PR na funkcję lub poprawkę. -- Przestrzegaj dobrych praktyk ESLint i TypeScript. -- Pisz jasne, opisowe commity odnoszące się do issues (np. `Fixes #123`). +- Przestrzegaj najlepszych praktyk ESLint i TypeScript. +- Pisz jasne, opisowe commity odwołujące się do zgłoszeń (np. `Naprawia #123`). - Zapewnij dokładne testy (`npm test`). -- Zrebase'uj na najnowszą gałąź `main` przed zgłoszeniem. +- Zrób rebase na najnowszą gałąź `main` przed przesłaniem. -### Zgłaszanie Pull Requesta +### Przesyłanie żądania ściągnięcia -- Zacznij od **wersji roboczej PR**, jeśli szukasz wczesnego feedbacku. -- Jasno opisz swoje zmiany, zgodnie z szablonem Pull Request. -- Dostarcz zrzuty ekranu/wideo dla zmian UI. -- Wskaż, czy potrzebne są aktualizacje dokumentacji. +- Zacznij jako **wersja robocza PR**, jeśli szukasz wczesnej opinii. +- Jasno opisz swoje zmiany, postępując zgodnie z szablonem żądania ściągnięcia. +- Połącz zgłoszenie w opisie/tytule PR (np. „Naprawia #123”). +- Udostępnij zrzuty ekranu/filmy wideo dotyczące zmian w interfejsie użytkownika. +- Wskaż, czy konieczne są aktualizacje dokumentacji. -### Polityka Pull Request +### Polityka dotycząca żądań ściągnięcia -- Musi odnosić się do wcześniej zatwierdzonych i przypisanych issues. -- PR niezgodne z polityką mogą zostać zamknięte. -- PR powinny przechodzić testy CI, być zgodne z roadmapą i mieć jasną dokumentację. +- Musi odnosić się do przypisanego zgłoszenia na GitHubie. Aby zostać przypisanym: skomentuj „Zgłaszam się” w zgłoszeniu i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)** na [Discordzie](https://discord.gg/roocode). Przypisanie zostanie potwierdzone w wątku. +- Niepołączone PR-y mogą zostać zamknięte. +- PR-y muszą przejść testy CI, być zgodne z mapą drogową i mieć przejrzystą dokumentację. -### Proces recenzji +### Proces przeglądu -- **Codzienna selekcja:** Szybkie sprawdzenia przez maintainerów. -- **Cotygodniowy dokładny przegląd:** Kompleksowa ocena. -- **Szybko iteruj** na podstawie feedbacku. +- **Codzienna selekcja:** Szybkie sprawdzanie przez opiekunów. +- **Cotygodniowy dogłębny przegląd:** Kompleksowa ocena. +- **Szybko iteruj** w oparciu o opinie. -## Prawne +## Kwestie prawne -Zgłaszając pull request, zgadzasz się, że twój wkład będzie licencjonowany na licencji Apache 2.0, zgodnie z licencją Roo Code. +Przesyłając wkład, zgadzasz się, że Twoje wkłady będą licencjonowane na podstawie licencji Apache 2.0, zgodnie z licencją Roo Code. diff --git a/locales/pt-BR/CONTRIBUTING.md b/locales/pt-BR/CONTRIBUTING.md index ae602a1ca02..a45da17f135 100644 --- a/locales/pt-BR/CONTRIBUTING.md +++ b/locales/pt-BR/CONTRIBUTING.md @@ -13,126 +13,129 @@ # Contribuindo para o Roo Code -O Roo Code é um projeto impulsionado pela comunidade e valorizamos muito cada contribuição. Para simplificar a colaboração, operamos com uma abordagem [Issue-First](#abordagem-issue-first), o que significa que todos os [Pull Requests (PRs)](#enviando-um-pull-request) devem primeiro estar vinculados a uma Issue do GitHub. Por favor, leia este guia com atenção. +O Roo Code é um projeto impulsionado pela comunidade, e valorizamos profundamente cada contribuição. Para agilizar a colaboração, operamos com base em uma [abordagem de "primeiro a issue"](#abordagem-de-primeiro-a-issue), o que significa que todas as [Pull Requests (PRs)](#enviando-uma-pull-request) devem primeiro estar vinculadas a uma Issue do GitHub. Por favor, revise este guia com atenção. ## Índice -- [Antes de Contribuir](#antes-de-contribuir) -- [Encontrando & Planejando sua Contribuição](#encontrando--planejando-sua-contribuição) -- [Processo de Desenvolvimento & Submissão](#processo-de-desenvolvimento--submissão) +- [Antes de contribuir](#antes-de-contribuir) +- [Encontrando e planejando sua contribuição](#encontrando-e-planejando-sua-contribuição) +- [Processo de desenvolvimento e envio](#processo-de-desenvolvimento-e-envio) - [Legal](#legal) -## Antes de Contribuir +## Antes de contribuir ### 1. Código de Conduta -Todos os colaboradores devem seguir nosso [Código de Conduta](./CODE_OF_CONDUCT.md). +Todos os contribuidores devem aderir ao nosso [Código de Conduta](./CODE_OF_CONDUCT.md). -### 2. Roadmap do Projeto +### 2. Roteiro do projeto -Nosso roadmap orienta a direção do projeto. Alinhe suas contribuições com estes objetivos principais: +Nosso roteiro guia a direção do projeto. Alinhe suas contribuições com estes objetivos principais: -### Confiabilidade em Primeiro Lugar +### Confiabilidade em primeiro lugar -- Garantir que a edição de diferenças e a execução de comandos sejam consistentemente confiáveis -- Reduzir pontos de atrito que desencorajam o uso regular -- Garantir operação suave em todos os idiomas e plataformas -- Expandir o suporte robusto para uma ampla variedade de provedores e modelos de IA +- Garanta que a edição de diff e a execução de comandos sejam consistentemente confiáveis. +- Reduza os pontos de atrito que desencorajam o uso regular. +- Garanta uma operação tranquila em todas as localidades e plataformas. +- Expanda o suporte robusto para uma ampla variedade de provedores e modelos de IA. -### Experiência de Usuário Aprimorada +### Experiência do usuário aprimorada -- Simplificar a interface do usuário para maior clareza e intuitividade -- Melhorar continuamente o fluxo de trabalho para atender às altas expectativas dos desenvolvedores +- Simplifique a UI/UX para clareza e intuitividade. +- Melhore continuamente o fluxo de trabalho para atender às altas expectativas que os desenvolvedores têm das ferramentas de uso diário. -### Liderança em Desempenho de Agentes +### Liderando no desempenho do agente -- Estabelecer benchmarks de avaliação abrangentes (evals) para medir a produtividade no mundo real -- Facilitar para que todos possam executar e interpretar essas avaliações -- Fornecer melhorias que demonstrem aumentos claros nas pontuações de avaliação +- Estabeleça benchmarks de avaliação abrangentes (evals) para medir a produtividade do mundo real. +- Facilite para que todos possam executar e interpretar facilmente essas avaliações. +- Envie melhorias que demonstrem aumentos claros nas pontuações de avaliação. -Mencione o alinhamento com estas áreas em seus PRs. +Mencione o alinhamento com essas áreas em seus PRs. -### 3. Junte-se à Comunidade Roo Code +### 3. Junte-se à comunidade Roo Code -- **Principal:** Junte-se ao nosso [Discord](https://discord.gg/roocode) e envie um DM para **Hannes Rudolph (`hrudolph`)**. -- **Alternativa:** Colaboradores experientes podem participar diretamente via [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). +- **Principal:** Junte-se ao nosso [Discord](https://discord.gg/roocode) e envie uma DM para **Hannes Rudolph (`hrudolph`)**. +- **Alternativa:** Contribuidores experientes могут se envolver diretamente através dos [Projetos do GitHub](https://github.com/orgs/RooCodeInc/projects/1). -## Encontrando & Planejando sua Contribuição +## Encontrando e planejando sua contribuição -### Tipos de Contribuição +### Tipos de contribuições -- **Correção de bugs:** Corrigir problemas no código. -- **Novos recursos:** Adicionar novas funcionalidades. -- **Documentação:** Melhorar guias e clareza. +- **Correções de bugs:** abordando problemas de código. +- **Novos recursos:** adicionando funcionalidade. +- **Documentação:** melhorando guias e clareza. -### Abordagem Issue-First +### Abordagem de primeiro a issue -Todas as contribuições devem começar com uma Issue do GitHub. +Todas as contribuições começam com uma Issue do GitHub usando nossos modelos simplificados. -- **Verificar issues existentes:** Procure em [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Criar uma issue:** Use os templates apropriados: - - **Bugs:** Template "Bug Report". - - **Recursos:** Template "Detailed Feature Proposal". Aprovação necessária antes de começar. -- **Reivindicar issues:** Comente e aguarde atribuição oficial. +- **Verifique as issues existentes**: Pesquise nas [Issues do GitHub](https://github.com/RooCodeInc/Roo-Code/issues). +- **Crie uma issue** usando: + - **Melhorias:** modelo "Solicitação de melhoria" (linguagem simples focada no benefício do usuário). + - **Bugs:** modelo "Relatório de bug" (reprodução mínima + esperado vs. real + versão). +- **Quer trabalhar nisso?** Comente "Reivindicando" na issue e envie uma DM para **Hannes Rudolph (`hrudolph`)** no [Discord](https://discord.gg/roocode) para ser atribuído. A atribuição será confirmada no tópico. +- **Os PRs devem ser vinculados à issue.** PRs não vinculados podem ser fechados. -**PRs sem issues aprovadas podem ser fechados.** +### Decidindo no que trabalhar -### Decidindo no que Trabalhar +- Verifique o [Projeto do GitHub](https://github.com/orgs/RooCodeInc/projects/1) para issues "Issue [Não atribuída]". +- Para documentação, visite [Documentação do Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs). -- Confira o [Projeto GitHub](https://github.com/orgs/RooCodeInc/projects/1) para "Good First Issues" não atribuídas. -- Para documentação, visite [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). +### Relatando bugs -### Relatando Bugs +- Verifique primeiro os relatórios existentes. +- Crie um novo bug usando o [modelo "Relatório de bug"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) com: + - Passos de reprodução claros e numerados + - Resultado esperado vs. real + - Versão do Roo Code (obrigatório); provedor/modelo de IA, se relevante +- **Problemas de segurança**: Relate em particular através de [avisos de segurança](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). -- Verifique primeiro se já existem relatórios. -- Crie novos relatórios de bugs usando o [template "Bug Report"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Vulnerabilidades de segurança:** Relate de forma privada via [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +## Processo de desenvolvimento e envio -## Processo de Desenvolvimento & Submissão +### Configuração de desenvolvimento -### Configuração de Desenvolvimento - -1. **Fork & Clone:** +1. **Fork e Clone:** ``` -git clone https://github.com/SEU_USUÁRIO/Roo-Code.git +git clone https://github.com/SEU_NOME_DE_USUARIO/Roo-Code.git ``` -2. **Instalar dependências:** +2. **Instale as dependências:** ``` -npm run install:all +pnpm install ``` -3. **Depuração:** Abra com VS Code (`F5`). +3. **Depuração:** Abra com o VS Code (`F5`). -### Diretrizes para Escrever Código +### Diretrizes para escrever código - Um PR focado por recurso ou correção. -- Siga as melhores práticas de ESLint e TypeScript. -- Escreva commits claros e descritivos referenciando issues (ex: `Fixes #123`). +- Siga as melhores práticas do ESLint e TypeScript. +- Escreva commits claros e descritivos referenciando issues (por exemplo, `Corrige #123`). - Forneça testes completos (`npm test`). -- Rebase na branch `main` mais recente antes do envio. +- Faça o rebase para o branch `main` mais recente antes do envio. -### Enviando um Pull Request +### Enviando uma Pull Request -- Comece como **PR em rascunho** se buscar feedback antecipado. -- Descreva claramente suas alterações seguindo o Template de Pull Request. -- Forneça capturas de tela/vídeos para alterações de UI. -- Indique se atualizações de documentação são necessárias. +- Comece como um **PR de rascunho** se estiver buscando feedback inicial. +- Descreva claramente suas alterações seguindo o Modelo de Pull Request. +- Vincule a issue na descrição/título do PR (por exemplo, "Corrige #123"). +- Forneça capturas de tela/vídeos para alterações na interface do usuário. +- Indique se as atualizações da documentação são necessárias. ### Política de Pull Request -- Deve referenciar issues pré-aprovadas e atribuídas. -- PRs que não seguem a política podem ser fechados. -- PRs devem passar nos testes de CI, alinhar-se ao roadmap e ter documentação clara. +- Deve fazer referência a uma Issue do GitHub atribuída. Para ser atribuído: comente "Reivindicando" na issue e envie uma DM para **Hannes Rudolph (`hrudolph`)** no [Discord](https://discord.gg/roocode). A atribuição será confirmada no tópico. +- PRs não vinculados podem ser fechados. +- Os PRs devem passar nos testes de CI, estar alinhados com o roteiro e ter documentação clara. -### Processo de Revisão +### Processo de revisão -- **Triagem diária:** Verificações rápidas pelos mantenedores. -- **Revisão semanal detalhada:** Avaliação abrangente. -- **Itere rapidamente** com base no feedback. +- **Triagem diária:** verificações rápidas pelos mantenedores. +- **Revisão aprofundada semanal:** avaliação abrangente. +- **Itere prontamente** com base no feedback. ## Legal -Ao enviar um pull request, você concorda que suas contribuições serão licenciadas sob a Licença Apache 2.0, consistente com o licenciamento do Roo Code. +Ao contribuir, você concorda que suas contribuições serão licenciadas sob a Licença Apache 2.0, consistente com o licenciamento do Roo Code. diff --git a/locales/ru/CONTRIBUTING.md b/locales/ru/CONTRIBUTING.md index 89a4e7d5292..fa3b1b2c294 100644 --- a/locales/ru/CONTRIBUTING.md +++ b/locales/ru/CONTRIBUTING.md @@ -13,126 +13,129 @@ # Вклад в Roo Code -Roo Code — проект, управляемый сообществом, и мы высоко ценим каждый вклад. Для упрощения сотрудничества мы работаем по принципу [Issue-First](#подход-issue-first), что означает, что все [Pull Request (PR)](#отправка-pull-request) должны сначала быть связаны с GitHub Issue. Пожалуйста, внимательно ознакомься с этим руководством. +Roo Code — это проект, управляемый сообществом, и мы глубоко ценим каждый вклад. Чтобы упростить совместную работу, мы работаем на основе [подхода «сначала задача»](#подход-сначала-задача), что означает, что все [запросы на слияние (PR)](#подача-запроса-на-слияние) должны быть сначала связаны с задачей на GitHub. Пожалуйста, внимательно ознакомьтесь с этим руководством. -## Содержание +## Оглавление -- [Перед тем как внести вклад](#перед-тем-как-внести-вклад) -- [Поиск и планирование вклада](#поиск-и-планирование-вклада) -- [Процесс разработки и отправки](#процесс-разработки-и-отправки) -- [Юридическая информация](#юридическая-информация) +- [Прежде чем вы начнете вносить свой вклад](#прежде-чем-вы-начнете-вносить-свой-вклад) +- [Поиск и планирование вашего вклада](#поиск-и-планирование-вашего-вклада) +- [Процесс разработки и подачи](#процесс-разработки-и-подачи) +- [Юридические вопросы](#юридические-вопросы) -## Перед тем как внести вклад +## Прежде чем вы начнете вносить свой вклад ### 1. Кодекс поведения -Все участники должны соблюдать наш [Кодекс поведения](./CODE_OF_CONDUCT.md). +Все участники должны придерживаться нашего [Кодекса поведения](./CODE_OF_CONDUCT.md). ### 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 на функцию или исправление. -- Следуй лучшим практикам 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. diff --git a/locales/tr/CONTRIBUTING.md b/locales/tr/CONTRIBUTING.md index f7bd4147b3b..4c73a15f65b 100644 --- a/locales/tr/CONTRIBUTING.md +++ b/locales/tr/CONTRIBUTING.md @@ -13,126 +13,129 @@ # Roo Code'a Katkıda Bulunma -Roo Code, topluluk odaklı bir projedir ve her katkıyı çok önemsiyoruz. İşbirliğini kolaylaştırmak için [Issue-First](#issue-first-yaklaşımı) yaklaşımıyla çalışıyoruz; bu, tüm [Pull Request'lerin (PR'lar)](#pull-request-gönderme) önce bir GitHub Issue'ya bağlanması gerektiği anlamına gelir. Lütfen bu rehberi dikkatlice incele. +Roo Code topluluk tarafından yürütülen bir projedir ve her katkıyı derinden takdir ediyoruz. İşbirliğini kolaylaştırmak için [Önce Sorun Yaklaşımı](#önce-sorun-yaklaşımı) temelinde çalışıyoruz, bu da tüm [Çekme İsteklerinin (PR'ler)](#bir-çekme-isteği-gönderme) önce bir GitHub Sorununa bağlanması gerektiği anlamına gelir. Lütfen bu kılavuzu dikkatlice inceleyin. ## İçindekiler -- [Katkıdan Önce](#katkıdan-önce) -- [Katkı Bulma & Planlama](#katkı-bulma--planlama) -- [Geliştirme & Gönderim Süreci](#geliştirme--gönderim-süreci) +- [Katkıda Bulunmadan Önce](#katkıda-bulunmadan-önce) +- [Katkınızı Bulma ve Planlama](#katkınızı-bulma-ve-planlama) +- [Geliştirme ve Gönderme Süreci](#geliştirme-ve-gönderme-süreci) - [Yasal](#yasal) -## Katkıdan Önce +## Katkıda Bulunmadan Önce ### 1. Davranış Kuralları -Tüm katkı sağlayanlar [Davranış Kuralları](./CODE_OF_CONDUCT.md)'na uymalıdır. +Tüm katkıda bulunanlar [Davranış Kurallarımıza](./CODE_OF_CONDUCT.md) uymalıdır. ### 2. Proje Yol Haritası -Yol haritamız projenin yönünü belirler. Katkılarını bu temel hedeflerle uyumlu hale getir: +Yol haritamız projenin yönünü belirler. Katkılarınızı bu temel hedeflerle hizalayın: -### Güvenilirlik Öncelikli +### Önce Güvenilirlik -- Diff düzenleme ve komut yürütme işlemlerinin sürekli olarak güvenilir olmasını sağlamak -- Düzenli kullanımı engelleyen sürtünme noktalarını azaltmak -- Tüm dillerde ve platformlarda sorunsuz çalışmayı garanti etmek -- Çok çeşitli yapay zeka sağlayıcıları ve modelleri için güçlü desteği genişletmek +- Fark düzenleme ve komut yürütmenin tutarlı bir şekilde güvenilir olduğundan emin olun. +- Düzenli kullanımı caydıran sürtünme noktalarını azaltın. +- Tüm yerellerde ve platformlarda sorunsuz çalışmayı garanti edin. +- Çok çeşitli yapay zeka sağlayıcıları ve modelleri için sağlam desteği genişletin. ### Geliştirilmiş Kullanıcı Deneyimi -- Daha fazla netlik ve sezgisellik için kullanıcı arayüzünü basitleştirmek -- Geliştiricilerin yüksek beklentilerini karşılamak üzere iş akışını sürekli iyileştirmek +- Netlik ve sezgisellik için kullanıcı arayüzünü/kullanıcı deneyimini kolaylaştırın. +- Geliştiricilerin günlük kullanım araçlarından beklentilerini karşılamak için iş akışını sürekli iyileştirin. ### Ajan Performansında Liderlik -- Gerçek dünyadaki üretkenliği ölçmek için kapsamlı değerlendirme kriterleri (evals) oluşturmak -- Herkesin bu değerlendirmeleri kolayca çalıştırıp yorumlamasını sağlamak -- Değerlendirme puanlarında net artışlar gösteren iyileştirmeler sunmak +- Gerçek dünya verimliliğini ölçmek için kapsamlı değerlendirme ölçütleri (eval'ler) oluşturun. +- Herkesin bu değerlendirmeleri kolayca çalıştırmasını ve yorumlamasını sağlayın. +- Değerlendirme puanlarında net artışlar gösteren iyileştirmeler gönderin. -PR'larında bu alanlarla olan bağlantıyı belirt. +PR'lerinizde bu alanlarla uyumu belirtin. -### 3. Roo Code Topluluğuna Katıl +### 3. Roo Code Topluluğuna Katılın -- **Ana yöntem:** [Discord](https://discord.gg/roocode)'umuza katıl ve **Hannes Rudolph (`hrudolph`)**'a DM gönder. -- **Alternatif:** Deneyimli katkı sağlayanlar [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1) üzerinden doğrudan katılabilir. +- **Birincil:** [Discord](https://discord.gg/roocode) sunucumuza katılın ve **Hannes Rudolph (`hrudolph`)**'a DM gönderin. +- **Alternatif:** Deneyimli katkıda bulunanlar doğrudan [GitHub Projeleri](https://github.com/orgs/RooCodeInc/projects/1) aracılığıyla etkileşimde bulunabilirler. -## Katkı Bulma & Planlama +## Katkınızı Bulma ve Planlama ### Katkı Türleri -- **Hata düzeltmeleri:** Koddaki sorunları çözmek. -- **Yeni özellikler:** Yeni işlevsellik eklemek. -- **Dokümantasyon:** Rehberleri geliştirmek ve netleştirmek. +- **Hata Düzeltmeleri:** kod sorunlarını giderme. +- **Yeni Özellikler:** işlevsellik ekleme. +- **Belgelendirme:** kılavuzları ve netliği iyileştirme. -### Issue-First Yaklaşımı +### Önce Sorun Yaklaşımı -Tüm katkılar bir GitHub Issue ile başlamalıdır. +Tüm katkılar, basit şablonlarımızı kullanarak bir GitHub Sorunu ile başlar. -- **Mevcut issue'ları kontrol et:** [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)'da ara. -- **Issue oluştur:** Uygun şablonları kullan: - - **Hatalar:** "Bug Report" şablonu. - - **Özellikler:** "Detailed Feature Proposal" şablonu. Başlamadan önce onay gerekir. -- **Issue'ları sahiplen:** Yorum yap ve resmi atamayı bekle. +- **Mevcut sorunları kontrol edin**: [GitHub Sorunları](https://github.com/RooCodeInc/Roo-Code/issues)nda arama yapın. +- **Bir sorun oluşturun**: + - **İyileştirmeler:** "İyileştirme İsteği" şablonu (kullanıcı yararına odaklanan sade bir dil). + - **Hatalar:** "Hata Raporu" şablonu (minimum yeniden oluşturma + beklenen vs gerçek + sürüm). +- **Üzerinde çalışmak ister misiniz?** Soruna "Talep ediyorum" yorumu yapın ve atanmak için [Discord](https://discord.gg/roocode) üzerinden **Hannes Rudolph (`hrudolph`)**'a DM gönderin. Atama, başlıkta teyit edilecektir. +- **PR'ler soruna bağlanmalıdır.** Bağlantısız PR'ler kapatılabilir. -**Onaylanmış issue'lara bağlı olmayan PR'lar kapatılabilir.** +### Ne Üzerinde Çalışılacağına Karar Verme -### Ne Üzerinde Çalışacağına Karar Verme +- "Sorun [Atanmamış]" sorunları için [GitHub Projesi](https://github.com/orgs/RooCodeInc/projects/1)'ni kontrol edin. +- Belgeler için [Roo Code Belgeleri](https://github.com/RooCodeInc/Roo-Code-Docs)ni ziyaret edin. -- [GitHub Projesi](https://github.com/orgs/RooCodeInc/projects/1)'nde atanmamış "Good First Issues" bak. -- Dokümantasyon için [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs)'u ziyaret et. +### Hataları Bildirme -### Hata veya Sorun Bildirme +- Önce mevcut raporları kontrol edin. +- Aşağıdakilerle ["Hata Raporu" şablonunu](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) kullanarak yeni bir hata oluşturun: + - Açık, numaralandırılmış yeniden oluşturma adımları + - Beklenen vs gerçek sonuç + - Roo Code sürümü (gerekli); ilgiliyse API sağlayıcısı/modeli +- **Güvenlik sorunları**: [Güvenlik tavsiyeleri](https://github.com/RooCodeInc/Roo-Code/security/advisories/new) aracılığıyla özel olarak bildirin. -- Önce mevcut raporları kontrol et. -- ["Bug Report" şablonu](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) kullanarak yeni hata raporları oluştur. -- **Güvenlik açıkları:** [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new) aracılığıyla özel olarak bildir. +## Geliştirme ve Gönderme Süreci -## Geliştirme & Gönderim Süreci +### Geliştirme Kurulumu -### Geliştirme Ortamı Kurulumu - -1. **Fork & Clone:** +1. **Çatallayın ve Klonlayın:** ``` -git clone https://github.com/KULLANICI_ADIN/Roo-Code.git +git clone https://github.com/KULLANICI_ADINIZ/Roo-Code.git ``` -2. **Bağımlılıkları yükle:** +2. **Bağımlılıkları Yükleyin:** ``` -npm run install:all +pnpm install ``` -3. **Hata ayıklama:** VS Code'da `F5` ile aç. +3. **Hata Ayıklama:** VS Code (`F5`) ile açın. -### Kod Yazma Rehberi +### Kod Yazma Yönergeleri -- Her özellik veya düzeltme için odaklı bir PR. -- ESLint ve TypeScript en iyi uygulamalarını takip et. -- Issue'lara referans veren açık, açıklayıcı commit mesajları yaz (örn. `Fixes #123`). -- Kapsamlı testler sağla (`npm test`). -- Göndermeden önce en son `main` branch'i üzerine rebase yap. +- Her özellik veya düzeltme için odaklanmış bir PR. +- ESLint ve TypeScript en iyi uygulamalarını takip edin. +- Sorunlara atıfta bulunan açık, açıklayıcı taahhütler yazın (ör. `Düzeltmeler #123`). +- Kapsamlı testler sağlayın (`npm test`). +- Göndermeden önce en son `main` dalına yeniden temel alın. -### Pull Request Gönderme +### Bir Çekme İsteği Gönderme -- Erken geri bildirim istiyorsan **taslak PR** olarak başla. -- Pull Request Şablonunu takip ederek değişikliklerini açıkça tanımla. -- UI değişiklikleri için ekran görüntüleri/videolar sağla. -- Dokümantasyon güncellemeleri gerekip gerekmediğini belirt. +- Erken geri bildirim arıyorsanız **Taslak PR** olarak başlayın. +- Çekme İsteği Şablonunu izleyerek değişikliklerinizi açıkça tanımlayın. +- PR açıklamasında/başlığında sorunu bağlayın (ör. "Düzeltmeler #123"). +- Kullanıcı arayüzü değişiklikleri için ekran görüntüleri/videolar sağlayın. +- Belge güncellemelerinin gerekli olup olmadığını belirtin. -### Pull Request Politikası +### Çekme İsteği Politikası -- Önceden onaylanmış ve atanmış issue'lara referans vermelidir. -- Politikaya uymayan PR'lar kapatılabilir. -- PR'lar CI testlerini geçmeli, yol haritasıyla uyumlu olmalı ve net dokümantasyona sahip olmalıdır. +- Atanmış bir GitHub Sorununa atıfta bulunmalıdır. Atanmak için: soruna "Talep ediyorum" yorumu yapın ve [Discord](https://discord.gg/roocode) üzerinden **Hannes Rudolph (`hrudolph`)**'a DM gönderin. Atama, başlıkta teyit edilecektir. +- Bağlantısız PR'ler kapatılabilir. +- PR'ler CI testlerini geçmeli, yol haritasıyla uyumlu olmalı ve net belgelere sahip olmalıdır. ### İnceleme Süreci -- **Günlük triyaj:** Maintainer'lar tarafından hızlı kontroller. -- **Haftalık detaylı inceleme:** Kapsamlı değerlendirme. -- **Geri bildirim temelinde hızla yinele.** +- **Günlük Triyaj:** Sürdürücüler tarafından hızlı kontroller. +- **Haftalık Derinlemesine İnceleme:** Kapsamlı değerlendirme. +- Geri bildirime göre **hızlı bir şekilde yineleyin**. ## Yasal -Pull request göndererek, katkılarının Roo Code'un lisanslamasıyla tutarlı olarak Apache 2.0 Lisansı altında lisanslanacağını kabul etmiş olursun. +Katkıda bulunarak, katkılarınızın Roo Code'un lisanslamasıyla tutarlı olan Apache 2.0 Lisansı altında lisanslanacağını kabul etmiş olursunuz. diff --git a/locales/vi/CONTRIBUTING.md b/locales/vi/CONTRIBUTING.md index d0f1d5ee583..6b3126c8074 100644 --- a/locales/vi/CONTRIBUTING.md +++ b/locales/vi/CONTRIBUTING.md @@ -13,126 +13,129 @@ # Đóng góp cho Roo Code -Roo Code là một dự án do cộng đồng dẫn dắt và chúng mình rất trân trọng mọi đóng góp. Để đơn giản hóa quy trình hợp tác, chúng mình áp dụng cách tiếp cận [Issue-First](#cách-tiếp-cận-issue-first), nghĩa là tất cả [Pull Request (PR)](#gửi-pull-request) phải được liên kết với một GitHub Issue trước. Vui lòng đọc kỹ hướng dẫn này. +Roo Code là một dự án do cộng đồng điều khiển và chúng tôi vô cùng trân trọng mọi đóng góp. Để hợp lý hóa việc cộng tác, chúng tôi hoạt động trên cơ sở [Ưu tiên vấn đề](#cách-tiếp-cận-ưu-tiên-vấn-đề), có nghĩa là tất cả các [Yêu cầu kéo (PR)](#gửi-yêu-cầu-kéo) trước tiên phải được liên kết với một Vấn đề trên GitHub. Vui lòng xem kỹ hướng dẫn này. -## Mục lục +## Bảng mục lục -- [Trước khi đóng góp](#trước-khi-đóng-góp) -- [Tìm kiếm & lên kế hoạch đóng góp](#tìm-kiếm--lên-kế-hoạch-đóng-góp) -- [Quy trình phát triển & gửi bài](#quy-trình-phát-triển--gửi-bài) +- [Trước khi bạn đóng góp](#trước-khi-bạn-đóng-góp) +- [Tìm kiếm và lập kế hoạch đóng góp của bạn](#tìm-kiếm-và-lập-kế-hoạch-đóng-góp-của-bạn) +- [Quy trình phát triển và gửi](#quy-trình-phát-triển-và-gửi) - [Pháp lý](#pháp-lý) -## Trước khi đóng góp +## Trước khi bạn đóng góp ### 1. Quy tắc ứng xử -Tất cả thành viên đóng góp phải tuân thủ [Quy tắc ứng xử](./CODE_OF_CONDUCT.md) của chúng mình. +Tất cả những người đóng góp phải tuân thủ [Quy tắc ứng xử](./CODE_OF_CONDUCT.md) của chúng tôi. -### 2. Lộ trình phát triển dự án +### 2. Lộ trình dự án -Lộ trình của chúng mình định hướng dự án. Hãy điều chỉnh đóng góp của bạn theo các mục tiêu chính: +Lộ trình của chúng tôi hướng dẫn định hướng của dự án. Hãy điều chỉnh những đóng góp của bạn với những mục tiêu chính này: -### Độ tin cậy là ưu tiên hàng đầu +### Ưu tiên độ tin cậy -- Đảm bảo việc chỉnh sửa diff và thực thi lệnh luôn đáng tin cậy -- Giảm thiểu các điểm cản trở khiến người dùng ngại sử dụng thường xuyên -- Đảm bảo hoạt động mượt mà trên mọi ngôn ngữ và nền tảng -- Mở rộng hỗ trợ mạnh mẽ cho nhiều nhà cung cấp và mô hình AI đa dạng +- Đảm bảo việc chỉnh sửa diff và thực thi lệnh luôn đáng tin cậy. +- Giảm các điểm ma sát ngăn cản việc sử dụng thường xuyên. +- Đảm bảo hoạt động trơn tru trên tất cả các ngôn ngữ và nền tảng. +- Mở rộng hỗ trợ mạnh mẽ cho nhiều nhà cung cấp và mô hình AI. -### Nâng cao trải nghiệm người dùng +### Trải nghiệm người dùng nâng cao -- Đơn giản hóa giao diện người dùng để tăng tính rõ ràng và trực quan -- Liên tục cải thiện quy trình làm việc để đáp ứng kỳ vọng cao của các nhà phát triển +- Hợp lý hóa giao diện người dùng/trải nghiệm người dùng để rõ ràng và trực quan. +- Liên tục cải thiện quy trình làm việc để đáp ứng những kỳ vọng cao của các nhà phát triển đối với các công cụ sử dụng hàng ngày. -### Dẫn đầu về hiệu suất agent +### Dẫn đầu về hiệu suất tác nhân -- Thiết lập các tiêu chuẩn đánh giá toàn diện (evals) để đo lường năng suất trong thực tế -- Giúp mọi người dễ dàng chạy và hiểu các đánh giá này -- Cung cấp các cải tiến thể hiện rõ sự tăng trưởng trong điểm đánh giá +- Thiết lập các tiêu chuẩn đánh giá toàn diện (evals) để đo lường năng suất trong thế giới thực. +- Giúp mọi người dễ dàng chạy và diễn giải các đánh giá này. +- Cung cấp các cải tiến cho thấy sự gia tăng rõ ràng về điểm số đánh giá. -Đề cập đến sự liên quan với các lĩnh vực này trong PR của bạn. +Hãy đề cập đến sự phù hợp với các lĩnh vực này trong PR của bạn. ### 3. Tham gia cộng đồng Roo Code -- **Cách chính:** Tham gia [Discord](https://discord.gg/roocode) của chúng mình và nhắn tin trực tiếp cho **Hannes Rudolph (`hrudolph`)**. -- **Cách thay thế:** Cộng tác viên có kinh nghiệm có thể tham gia trực tiếp qua [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1). +- **Chính:** Tham gia [Discord](https://discord.gg/roocode) của chúng tôi và nhắn tin trực tiếp cho **Hannes Rudolph (`hrudolph`)**. +- **Thay thế:** Những người đóng góp có kinh nghiệm có thể tham gia trực tiếp qua [Dự án GitHub](https://github.com/orgs/RooCodeInc/projects/1). -## Tìm kiếm & lên kế hoạch đóng góp +## Tìm kiếm và lập kế hoạch đóng góp của bạn ### Các loại đóng góp -- **Sửa lỗi:** Khắc phục vấn đề trong mã nguồn. -- **Tính năng mới:** Thêm chức năng mới. -- **Tài liệu:** Cải thiện hướng dẫn và độ rõ ràng. +- **Sửa lỗi:** giải quyết các vấn đề về mã. +- **Tính năng mới:** thêm chức năng. +- **Tài liệu:** cải thiện hướng dẫn và sự rõ ràng. -### Cách tiếp cận Issue-First +### Cách tiếp cận Ưu tiên vấn đề -Mọi đóng góp đều phải bắt đầu bằng một GitHub Issue. +Tất cả các đóng góp đều bắt đầu bằng một Vấn đề trên GitHub bằng cách sử dụng các mẫu gọn nhẹ của chúng tôi. -- **Kiểm tra issue hiện có:** Tìm kiếm trong [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). -- **Tạo issue mới:** Sử dụng mẫu phù hợp: - - **Lỗi:** Mẫu "Bug Report". - - **Tính năng:** Mẫu "Detailed Feature Proposal". Cần được phê duyệt trước khi bắt đầu. -- **Nhận issue:** Bình luận và chờ được gán chính thức. +- **Kiểm tra các vấn đề hiện có**: Tìm kiếm trong [Vấn đề trên GitHub](https://github.com/RooCodeInc/Roo-Code/issues). +- **Tạo một vấn đề** bằng cách sử dụng: + - **Cải tiến:** mẫu "Yêu cầu cải tiến" (ngôn ngữ đơn giản tập trung vào lợi ích của người dùng). + - **Lỗi:** mẫu "Báo cáo lỗi" (tái tạo tối thiểu + mong đợi so với thực tế + phiên bản). +- **Bạn muốn làm việc với nó?** Bình luận "Nhận" trên vấn đề và nhắn tin trực tiếp cho **Hannes Rudolph (`hrudolph`)** trên [Discord](https://discord.gg/roocode) để được giao. Việc giao nhiệm vụ sẽ được xác nhận trong chuỗi. +- **PR phải liên kết đến vấn đề.** Các PR không được liên kết có thể bị đóng. -**PR không có issue đã duyệt có thể bị đóng.** +### Quyết định nên làm gì -### Quyết định việc cần làm - -- Xem [Dự án GitHub](https://github.com/orgs/RooCodeInc/projects/1) để tìm "Good First Issues" chưa được gán. -- Về tài liệu, hãy xem [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs). +- Kiểm tra [Dự án GitHub](https://github.com/orgs/RooCodeInc/projects/1) để tìm các vấn đề "Vấn đề [Chưa được giao]". +- Để biết tài liệu, hãy truy cập [Tài liệu Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs). ### Báo cáo lỗi -- Kiểm tra báo cáo hiện có trước. -- Tạo báo cáo lỗi mới bằng [mẫu "Bug Report"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). -- **Lỗ hổng bảo mật:** Báo cáo riêng qua [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +- Trước tiên hãy kiểm tra các báo cáo hiện có. +- Tạo một lỗi mới bằng cách sử dụng [mẫu "Báo cáo lỗi"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) với: + - Các bước tái tạo rõ ràng, được đánh số + - Kết quả mong đợi so với thực tế + - Phiên bản Roo Code (bắt buộc); nhà cung cấp/mô hình API nếu có liên quan +- **Vấn đề bảo mật**: Báo cáo riêng tư qua [tư vấn bảo mật](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). -## Quy trình phát triển & gửi bài +## Quy trình phát triển và gửi -### Thiết lập môi trường phát triển +### Thiết lập phát triển -1. **Fork & Clone:** +1. **Rẽ nhánh & Sao chép:** ``` -git clone https://github.com/TEN_TAI_KHOAN/Roo-Code.git +git clone https://github.com/TÊN_NGƯỜI_DÙNG_CỦA_BẠN/Roo-Code.git ``` -2. **Cài đặt phụ thuộc:** +2. **Cài đặt các phụ thuộc:** ``` -npm run install:all +pnpm install ``` -3. **Debug:** Mở bằng VS Code (`F5`). +3. **Gỡ lỗi:** Mở bằng VS Code (`F5`). ### Hướng dẫn viết mã -- Mỗi PR chỉ tập trung vào một tính năng hoặc sửa lỗi. -- Tuân thủ các thực hành tốt nhất của ESLint và TypeScript. -- Viết thông điệp commit rõ ràng, tham chiếu đến issue (ví dụ: `Fixes #123`). -- Cung cấp bài kiểm tra đầy đủ (`npm test`). -- Rebase trên nhánh `main` mới nhất trước khi gửi. +- Một PR tập trung cho mỗi tính năng hoặc bản sửa lỗi. +- Tuân thủ các phương pháp hay nhất của ESLint và TypeScript. +- Viết các cam kết rõ ràng, mô tả có tham chiếu đến các vấn đề (ví dụ: `Sửa lỗi #123`). +- Cung cấp thử nghiệm kỹ lưỡng (`npm test`). +- Rebase lên nhánh `main` mới nhất trước khi gửi. -### Gửi Pull Request +### Gửi yêu cầu kéo -- Bắt đầu với **PR nháp** nếu muốn nhận phản hồi sớm. -- Mô tả rõ ràng các thay đổi, tuân theo Mẫu Pull Request. -- Cung cấp ảnh chụp/video cho thay đổi UI. -- Chỉ rõ nếu cần cập nhật tài liệu. +- Bắt đầu với tư cách là **PR nháp** nếu bạn đang tìm kiếm phản hồi sớm. +- Mô tả rõ ràng những thay đổi của bạn theo Mẫu yêu cầu kéo. +- Liên kết vấn đề trong mô tả/tiêu đề PR (ví dụ: "Sửa lỗi #123"). +- Cung cấp ảnh chụp màn hình/video cho các thay đổi giao diện người dùng. +- Cho biết nếu cần cập nhật tài liệu. -### Chính sách Pull Request +### Chính sách yêu cầu kéo -- Phải tham chiếu đến issue đã được phê duyệt và gán. -- PR không tuân thủ chính sách có thể bị đóng. -- PR cần vượt qua kiểm tra CI, phù hợp với lộ trình và có tài liệu rõ ràng. +- Phải tham chiếu đến một Vấn đề GitHub đã được giao. Để được giao: bình luận "Nhận" trên vấn đề và nhắn tin trực tiếp cho **Hannes Rudolph (`hrudolph`)** trên [Discord](https://discord.gg/roocode). Việc giao nhiệm vụ sẽ được xác nhận trong chuỗi. +- Các PR không được liên kết có thể bị đóng. +- Các PR phải vượt qua các bài kiểm tra CI, phù hợp với lộ trình và có tài liệu rõ ràng. -### Quy trình đánh giá +### Quy trình xem xét -- **Phân loại hàng ngày:** Kiểm tra nhanh bởi maintainer. -- **Đánh giá chi tiết hàng tuần:** Đánh giá toàn diện. +- **Phân loại hàng ngày:** kiểm tra nhanh bởi những người bảo trì. +- **Xem xét sâu hàng tuần:** đánh giá toàn diện. - **Lặp lại nhanh chóng** dựa trên phản hồi. ## Pháp lý -Khi gửi pull request, bạn đồng ý rằng đóng góp của mình sẽ được cấp phép theo Giấy phép Apache 2.0, phù hợp với giấy phép của Roo Code. +Bằng cách đóng góp, bạn đồng ý rằng những đóng góp của bạn sẽ được cấp phép theo Giấy phép Apache 2.0, phù hợp với việc cấp phép của Roo Code. diff --git a/locales/zh-CN/CONTRIBUTING.md b/locales/zh-CN/CONTRIBUTING.md index f1cbacc46c4..fa1ce2a798b 100644 --- a/locales/zh-CN/CONTRIBUTING.md +++ b/locales/zh-CN/CONTRIBUTING.md @@ -11,128 +11,131 @@ -# 参与 Roo Code 贡献 +# 为 Roo Code 做贡献 -Roo Code 是一个由社区驱动的项目，我们高度重视每一份贡献。为了简化协作流程，我们采用 [Issue-First](#issue-first-方式) 原则，这意味着所有 [Pull Request (PR)](#提交-pull-request) 必须首先关联到 GitHub Issue。请仔细阅读本指南。 +Roo Code 是一个由社区驱动的项目，我们非常重视每一份贡献。为了简化协作，我们采用 [“问题优先” 的方法](#问题优先方法)，这意味着所有的 [拉取请求 (PR)](#提交拉取请求) 都必须首先链接到一个 GitHub 问题。请仔细阅读本指南。 ## 目录 -- [贡献前须知](#贡献前须知) -- [寻找与规划你的贡献](#寻找与规划你的贡献) -- [开发与提交流程](#开发与提交流程) -- [法律声明](#法律声明) +- [在您贡献之前](#在您贡献之前) +- [寻找和规划您的贡献](#寻找和规划您的贡献) +- [开发和提交流程](#开发和提交流程) +- [法律](#法律) -## 贡献前须知 +## 在您贡献之前 ### 1. 行为准则 -所有贡献者必须遵守我们的[行为准则](./CODE_OF_CONDUCT.md)。 +所有贡献者都必须遵守我们的 [行为准则](./CODE_OF_CONDUCT.md)。 ### 2. 项目路线图 -我们的路线图指引项目方向。请将你的贡献与这些关键目标保持一致： +我们的路线图指导着项目的方向。请将您的贡献与这些关键目标保持一致： -### 可靠性优先 +### 可靠性第一 -- 确保差异编辑和命令执行始终可靠 -- 减少阻碍常规使用的摩擦点 -- 确保在所有语言环境和平台上流畅运行 -- 扩展对各种 AI 提供商和模型的强大支持 +- 确保差异编辑和命令执行始终可靠。 +- 减少阻碍常规使用的摩擦点。 +- 保证在所有地区和平台上的流畅操作。 +- 扩大对各种人工智能提供商和模型的强大支持。 -### 增强用户体验 +### 增强的用户体验 -- 简化用户界面，提高清晰度和直观性 -- 持续改进工作流程，满足开发者对日常工具的高期望 +- 简化用户界面/用户体验，以提高清晰度和直观性。 +- 不断改进工作流程，以满足开发人员对日常使用工具的高期望。 -### 引领代理性能 +### 在代理性能上领先 -- 建立全面的评估基准（evals）衡量实际工作中的生产力 -- 让每个人都能轻松运行和解读这些评估 -- 提供明显提升评分的改进 +- 建立全面的评估基准 (evals) 来衡量真实世界的生产力。 +- 让每个人都能轻松运行和解释这些评估。 +- 发布能显示评估分数明显提高的改进。 -在 PR 中请提及与这些领域的关联。 +在您的 PR 中提及与这些领域的一致性。 ### 3. 加入 Roo Code 社区 - **主要方式：** 加入我们的 [Discord](https://discord.gg/roocode) 并私信 **Hannes Rudolph (`hrudolph`)**。 -- **替代方式：** 有经验的贡献者可通过 [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1) 直接参与。 +- **替代方式：** 经验丰富的贡献者可以通过 [GitHub 项目](https://github.com/orgs/RooCodeInc/projects/1) 直接参与。 -## 寻找与规划你的贡献 +## 寻找和规划您的贡献 ### 贡献类型 -- **Bug 修复：** 解决代码问题。 -- **新功能：** 添加新功能。 -- **文档：** 完善指南和提高清晰度。 +- **错误修复：** 解决代码问题。 +- **新功能：** 添加功能。 +- **文档：** 改进指南和清晰度。 -### Issue-First 方式 +### 问题优先方法 -所有贡献必须从 GitHub Issue 开始。 +所有贡献都始于使用我们精简模板的 GitHub 问题。 -- **检查现有 issue：** 搜索 [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)。 -- **创建 issue：** 使用适当模板： - - **Bug：** "Bug Report" 模板。 - - **功能：** "Detailed Feature Proposal" 模板。开始前需获得批准。 -- **认领 issue：** 评论并等待正式分配。 +- **检查现有问题**：在 [GitHub 问题](https://github.com/RooCodeInc/Roo-Code/issues) 中搜索。 +- **使用以下模板创建问题**： + - **增强功能：** “增强请求”模板（侧重于用户利益的简单语言）。 + - **错误：** “错误报告”模板（最少的复现步骤 + 预期与实际 + 版本）。 +- **想参与其中吗？** 在问题上评论“领取”，并在[Discord](https://discord.gg/roocode)上私信 **Hannes Rudolph (`hrudolph`)** 以获得分配。分配将在帖子中确认。 +- **PR 必须链接到问题。** 未链接的 PR 可能会被关闭。 -**未关联已批准 issue 的 PR 可能会被关闭。** +### 决定做什么 -### 决定要做什么 +- 查看 [GitHub 项目](https://github.com/orgs/RooCodeInc/projects/1) 中的“问题 [未分配]”问题。 +- 如需文档，请访问 [Roo Code 文档](https://github.com/RooCodeInc/Roo-Code-Docs)。 -- 查看 [GitHub 项目](https://github.com/orgs/RooCodeInc/projects/1) 中未分配的 "Good First Issues"。 -- 文档相关，请访问 [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs)。 +### 报告错误 -### 报告 Bug +- 首先检查现有的报告。 +- 使用 [“错误报告”模板](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) 创建一个新错误，并提供： + - 清晰、编号的复现步骤 + - 预期与实际结果 + - Roo Code 版本（必需）；如果相关，还需提供 API 提供商/模型 +- **安全问题**：通过 [安全公告](https://github.com/RooCodeInc/Roo-Code/security/advisories/new) 私下报告。 -- 先检查是否已有相关报告。 -- 使用 ["Bug Report" 模板](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) 创建新 bug 报告。 -- **安全问题：** 通过 [security advisories](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 专注于一个功能或修复。 -- 遵循 ESLint 和 TypeScript 最佳实践。 -- 编写清晰的提交信息，引用相关 issue（如 `Fixes #123`）。 -- 提供完整测试（`npm test`）。 -- 提交前先在最新 `main` 分支上进行 rebase。 +- 每个功能或修复一个集中的 PR。 +- 遵循 ESLint 和 TypeScript 的最佳实践。 +- 编写清晰、描述性的提交，并引用问题（例如，`修复 #123`）。 +- 提供全面的测试（`npm test`）。 +- 在提交前变基到最新的 `main` 分支。 -### 提交 Pull Request +### 提交拉取请求 -- 如需早期反馈，可先提交**草稿 PR**。 -- 清晰描述你的更改，遵循 Pull Request 模板。 -- 为 UI 变更提供截图/视频。 -- 说明是否需要更新文档。 +- 如果希望获得早期反馈，请以 **草稿 PR** 开始。 +- 遵循拉取请求模板，清晰地描述您的更改。 +- 在 PR 描述/标题中链接问题（例如，“修复 #123”）。 +- 为用户界面更改提供屏幕截图/视频。 +- 指明是否需要更新文档。 -### Pull Request 政策 +### 拉取请求政策 -- 必须引用已批准并分配的 issue。 -- 不遵守政策的 PR 可能会被关闭。 -- PR 应通过 CI 测试，符合路线图，并有清晰文档。 +- 必须引用一个已分配的 GitHub 问题。要获得分配：在问题上评论“领取”，并在[Discord](https://discord.gg/roocode)上私信 **Hannes Rudolph (`hrudolph`)**。分配将在帖子中确认。 +- 未链接的 PR 可能会被关闭。 +- PR 必须通过 CI 测试，与路线图保持一致，并有清晰的文档。 ### 审查流程 -- **每日筛查：** 维护者快速检查。 +- **每日分类：** 维护人员进行快速检查。 - **每周深入审查：** 全面评估。 -- **根据反馈快速迭代**。 +- **根据反馈及时迭代**。 -## 法律声明 +## 法律 -提交贡献即表示你同意你的贡献将基于 Apache 2.0 许可证，与 Roo Code 的许可一致。 +通过贡献，您同意您的贡献将根据 Apache 2.0 许可证进行许可，这与 Roo Code 的许可一致。 diff --git a/locales/zh-TW/CONTRIBUTING.md b/locales/zh-TW/CONTRIBUTING.md index 11f83863f69..82313d75616 100644 --- a/locales/zh-TW/CONTRIBUTING.md +++ b/locales/zh-TW/CONTRIBUTING.md @@ -11,128 +11,131 @@ -# 參與 Roo Code 貢獻 +# 為 Roo Code 做出貢獻 -Roo Code 是一個由社群驅動的專案，我們深深重視每一份貢獻。為了簡化協作流程，我們採用 [Issue-First](#issue-first-方式) 原則，這表示所有 [Pull Request (PR)](#提交-pull-request) 必須先關聯至 GitHub Issue。請仔細閱讀本指南。 +Roo Code 是一個由社群驅動的專案，我們非常重視每一份貢獻。為了簡化協作，我們採用 [「問題優先」的方法](#問題優先方法)，這意味著所有的 [拉取請求 (PR)](#提交拉取請求) 都必須先連結到一個 GitHub 問題。請仔細閱讀本指南。 ## 目錄 -- [貢獻前須知](#貢獻前須知) -- [尋找與規劃你的貢獻](#尋找與規劃你的貢獻) -- [開發與提交流程](#開發與提交流程) -- [法律聲明](#法律聲明) +- [在您貢獻之前](#在您貢獻之前) +- [尋找和規劃您的貢獻](#尋找和規劃您的貢獻) +- [開發和提交流程](#開發和提交流程) +- [法律](#法律) -## 貢獻前須知 +## 在您貢獻之前 ### 1. 行為準則 -所有貢獻者必須遵守我們的[行為準則](./CODE_OF_CONDUCT.md)。 +所有貢獻者都必須遵守我們的 [行為準則](./CODE_OF_CONDUCT.md)。 -### 2. 專案藍圖 +### 2. 專案路線圖 -我們的藍圖指引專案方向。請將你的貢獻與這些關鍵目標保持一致： +我們的路線圖指導著專案的方向。請將您的貢獻與這些關鍵目標保持一致： -### 可靠性優先 +### 可靠性第一 -- 確保差異編輯和命令執行始終可靠 -- 減少阻礙常規使用的摩擦點 -- 確保在所有語言環境和平台上順暢運行 -- 擴展對各種 AI 供應商和模型的強大支援 +- 確保差異編輯和命令執行始終可靠。 +- 減少阻礙常規使用的摩擦點。 +- 保證在所有地區和平台上的流暢操作。 +- 擴大對各種人工智慧提供商和模型的強大支援。 -### 增強使用者體驗 +### 增強的使用者體驗 -- 簡化使用者介面，提高清晰度和直覺性 -- 持續改進工作流程，滿足開發者對日常工具的高期望 +- 簡化使用者介面/使用者體驗，以提高清晰度和直觀性。 +- 不斷改進工作流程，以滿足開發人員對日常使用工具的高期望。 -### 引領代理效能 +### 在代理效能上領先 -- 建立全面的評估基準（evals）衡量實際工作中的生產力 -- 讓每個人都能輕鬆執行和解讀這些評估 -- 提供明顯提升評分的改進 +- 建立全面的評估基準 (evals) 來衡量真實世界的生產力。 +- 讓每個人都能輕鬆執行和解釋這些評估。 +- 發布能顯示評估分數明顯提高的改進。 -在 PR 中請提及與這些領域的關聯。 +在您的 PR 中提及與這些領域的一致性。 ### 3. 加入 Roo Code 社群 - **主要方式：** 加入我們的 [Discord](https://discord.gg/roocode) 並私訊 **Hannes Rudolph (`hrudolph`)**。 -- **替代方式：** 有經驗的貢獻者可透過 [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1) 直接參與。 +- **替代方式：** 經驗豐富的貢獻者可以透過 [GitHub 專案](https://github.com/orgs/RooCodeInc/projects/1) 直接參與。 -## 尋找與規劃你的貢獻 +## 尋找和規劃您的貢獻 ### 貢獻類型 -- **Bug 修正：** 解決程式碼問題。 +- **錯誤修復：** 解決程式碼問題。 - **新功能：** 新增功能。 -- **文件：** 完善指南和提高清晰度。 +- **文件：** 改進指南和清晰度。 -### Issue-First 方式 +### 問題優先方法 -所有貢獻必須從 GitHub Issue 開始。 +所有貢獻都始於使用我們精簡範本的 GitHub 問題。 -- **檢查現有 issue：** 搜尋 [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)。 -- **建立 issue：** 使用適當範本： - - **Bug：** 「Bug Report」範本。 - - **功能：** 「Detailed Feature Proposal」範本。開始前需獲得批准。 -- **認領 issue：** 留言並等待正式分配。 +- **檢查現有問題**：在 [GitHub 問題](https://github.com/RooCodeInc/Roo-Code/issues) 中搜尋。 +- **使用以下範本建立問題**： + - **增強功能：** 「增強請求」範本（著重於使用者利益的簡單語言）。 + - **錯誤：** 「錯誤報告」範本（最少的重現步驟 + 預期與實際 + 版本）。 +- **想參與其中嗎？** 在問題上評論“領取”，並在[Discord](https://discord.gg/roocode)上私訊 **Hannes Rudolph (`hrudolph`)** 以獲得分配。分配將在帖子中確認。 +- **PR 必須連結到問題。** 未連結的 PR 可能會被關閉。 -**未關聯已批准 issue 的 PR 可能會被關閉。** +### 決定做什麼 -### 決定要做什麼 +- 查看 [GitHub 專案](https://github.com/orgs/RooCodeInc/projects/1) 中的「問題 [未分配]」問題。 +- 如需文件，請造訪 [Roo Code 文件](https://github.com/RooCodeInc/Roo-Code-Docs)。 -- 查看 [GitHub 專案](https://github.com/orgs/RooCodeInc/projects/1) 中未分配的「Good First Issues」。 -- 文件相關，請訪問 [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs)。 +### 報告錯誤 -### 回報 Bug +- 首先檢查現有的報告。 +- 使用 [「錯誤報告」範本](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) 建立一個新錯誤，並提供： + - 清晰、編號的重現步驟 + - 預期與實際結果 + - Roo Code 版本（必需）；如果相關，還需提供 API 提供商/模型 +- **安全問題**：透過 [安全公告](https://github.com/RooCodeInc/Roo-Code/security/advisories/new) 私下報告。 -- 先檢查是否已有相關報告。 -- 使用 [「Bug Report」範本](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) 建立新 bug 報告。 -- **安全問題：** 透過 [security advisories](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 專注於一個功能或修正。 -- 遵循 ESLint 和 TypeScript 最佳實踐。 -- 撰寫清晰的提交訊息，引用相關 issue（如 `Fixes #123`）。 -- 提供完整測試（`npm test`）。 -- 提交前先在最新 `main` 分支上進行 rebase。 +- 每個功能或修復一個集中的 PR。 +- 遵循 ESLint 和 TypeScript 的最佳實踐。 +- 編寫清晰、描述性的提交，並引用問題（例如，`修復 #123`）。 +- 提供全面的測試（`npm test`）。 +- 在提交前變基到最新的 `main` 分支。 -### 提交 Pull Request +### 提交拉取請求 -- 如需早期回饋，可先提交**草稿 PR**。 -- 清晰描述你的更改，遵循 Pull Request 範本。 -- 為 UI 變更提供截圖/影片。 -- 說明是否需要更新文件。 +- 如果希望獲得早期回饋，請以 **草稿 PR** 開始。 +- 遵循拉取請求範本，清晰地描述您的變更。 +- 在 PR 描述/標題中連結問題（例如，“修復 #123”）。 +- 為使用者介面變更提供螢幕截圖/影片。 +- 指明是否需要更新文件。 -### Pull Request 政策 +### 拉取請求政策 -- 必須引用已批准並分配的 issue。 -- 不遵守政策的 PR 可能會被關閉。 -- PR 應通過 CI 測試，符合藍圖，並有清晰文件。 +- 必須引用一個已分配的 GitHub 問題。要獲得分配：在問題上評論“領取”，並在[Discord](https://discord.gg/roocode)上私訊 **Hannes Rudolph (`hrudolph`)**。分配將在帖子中確認。 +- 未連結的 PR 可能會被關閉。 +- PR 必須通過 CI 測試，與路線圖保持一致，並有清晰的文件。 ### 審查流程 -- **每日篩查：** 維護者快速檢查。 +- **每日分類：** 維護人員進行快速檢查。 - **每週深入審查：** 全面評估。 -- **根據回饋快速迭代**。 +- **根據回饋及時迭代**。 -## 法律聲明 +## 法律 -提交貢獻即表示你同意你的貢獻將基於 Apache 2.0 授權條款，與 Roo Code 的授權一致。 +透過貢獻，您同意您的貢獻將根據 Apache 2.0 授權進行授權，這與 Roo Code 的授權一致。