diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f97d2d6660..d54791f3cd 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code is a community-driven project, and we deeply value every contribution. - [Before You Contribute](#before-you-contribute) - [Finding & Planning Your Contribution](#finding--planning-your-contribution) + - [Feature Requests vs. Detailed Feature Proposals](#feature-requests-vs-detailed-feature-proposals) - [Development & Submission Process](#development--submission-process) - [Legal](#legal) @@ -63,7 +64,7 @@ All contributions must begin with a GitHub Issue. - **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. + - **Features:** "Detailed Feature Proposal" template. Approval required before starting. (See [Feature Requests vs. Detailed Feature Proposals](#feature-requests-vs-detailed-feature-proposals) below) - **Claim issues**: Comment and await official assignment. **PRs without approved issues may be closed.** @@ -79,6 +80,46 @@ All contributions must begin with a GitHub Issue. - Create new bugs using the ["Bug Report" template](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). - **Security issues**: Report privately via [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +### Feature Requests vs. Detailed Feature Proposals + +Understanding the difference between these two submission types is crucial for choosing the right approach: + +#### Feature Request (GitHub Discussions) + +**Purpose**: Share general ideas or suggestions without detailed planning. + +**How to Submit**: + +- Navigate to [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- Or click the "Feature Request" link when pressing the "New Issue" button in the issues section + +**Use this when**: + +- Your idea isn't fully developed yet +- You'd like community input or feedback +- You're proposing ideas without plans to implement them personally + +#### Detailed Feature Proposal (GitHub Issues) + +**Purpose**: Clearly outlined features intended for immediate implementation after approval. + +**How to Submit**: + +- Navigate to [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Click "New Issue" and select the "Detailed Feature Proposal" template + +**Use this when**: + +- Your feature is thoroughly planned and ready for approval +- You or someone else intends to implement the feature soon +- Formal approval is needed before starting development + +**Note**: Detailed Feature Proposals must be approved and assigned by a maintainer before beginning implementation, as mentioned in the [Issue-First Approach](#issue-first-approach) section above. + +![Issue Template Selection](placeholder-for-issue-template-selection-image) + +**Important**: Choosing the wrong template might lead to your submission being redirected or closed. Do not use Bug Reports for feature ideas. + ## Development & Submission Process ### Development Setup diff --git a/locales/ca/CONTRIBUTING.md b/locales/ca/CONTRIBUTING.md index 09d8727954..aec140e530 100644 --- a/locales/ca/CONTRIBUTING.md +++ b/locales/ca/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code és un projecte impulsat per la comunitat i valorem molt cada contribuc - [Abans de contribuir](#abans-de-contribuir) - [Trobar i planificar la teva contribució](#trobar-i-planificar-la-teva-contribució) + - [Sol·licituds de funcionalitats vs. Propostes detallades de funcionalitats](#sol·licituds-de-funcionalitats-vs-propostes-detallades-de-funcionalitats) - [Procés de desenvolupament i enviament](#procés-de-desenvolupament-i-enviament) - [Legal](#legal) @@ -63,7 +64,7 @@ Totes les contribucions han de començar amb una Issue de GitHub. - **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. + - **Funcionalitats:** Plantilla "Detailed Feature Proposal". Es requereix aprovació abans de començar. (Vegeu [Sol·licituds de funcionalitats vs. Propostes detallades de funcionalitats](#sol·licituds-de-funcionalitats-vs-propostes-detallades-de-funcionalitats) a continuació) - **Reclamar issues:** Comenta i espera l'assignació oficial. **Els PRs sense issues aprovades poden ser tancats.** @@ -79,6 +80,46 @@ Totes les contribucions han de començar amb una Issue de GitHub. - 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). +### Sol·licituds de funcionalitats vs. Propostes detallades de funcionalitats + +Entendre la diferència entre aquests dos tipus d'enviament és crucial per triar l'enfocament correcte: + +#### Sol·licitud de funcionalitat (GitHub Discussions) + +**Propòsit**: Compartir idees o suggeriments generals sense una planificació detallada. + +**Com enviar**: + +- Navega a [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- O fes clic a l'enllaç "Feature Request" quan premis el botó "New Issue" a la secció d'issues + +**Utilitza això quan**: + +- La teva idea encara no està completament desenvolupada +- Vols comentaris o feedback de la comunitat +- Proposes idees sense plans d'implementar-les personalment + +#### Proposta detallada de funcionalitat (GitHub Issues) + +**Propòsit**: Funcionalitats clarament definides destinades a la implementació immediata després de l'aprovació. + +**Com enviar**: + +- Navega a [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Fes clic a "New Issue" i selecciona la plantilla "Detailed Feature Proposal" + +**Utilitza això quan**: + +- La teva funcionalitat està completament planificada i llesta per a l'aprovació +- Tu o algú altre té la intenció d'implementar la funcionalitat aviat +- Es necessita aprovació formal abans de començar el desenvolupament + +**Nota**: Les Propostes detallades de funcionalitats han de ser aprovades i assignades per un mantenidor abans de començar la implementació, com es menciona a la secció [Enfoc Issue-First](#enfoc-issue-first) anterior. + +![Selecció de plantilla d'Issue](placeholder-for-issue-template-selection-image) + +**Important**: Triar la plantilla incorrecta pot fer que el teu enviament sigui redirigit o tancat. No utilitzis Informes d'errors per a idees de funcionalitats. + ## Procés de desenvolupament i enviament ### Configuració de desenvolupament diff --git a/locales/de/CONTRIBUTING.md b/locales/de/CONTRIBUTING.md index bb8d26561f..b7f44b41dd 100644 --- a/locales/de/CONTRIBUTING.md +++ b/locales/de/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code ist ein Community-getriebenes Projekt, und wir schätzen jeden Beitrag - [Bevor du beiträgst](#bevor-du-beiträgst) - [Beitrag finden & planen](#beitrag-finden--planen) + - [Feature-Anfragen vs. Detaillierte Feature-Vorschläge](#feature-anfragen-vs-detaillierte-feature-vorschläge) - [Entwicklung & Einreichung](#entwicklung--einreichung) - [Rechtliches](#rechtliches) @@ -63,7 +64,7 @@ Alle Beiträge müssen mit einem GitHub Issue beginnen. - **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. + - **Features:** "Detailed Feature Proposal"-Vorlage. Vor dem Start ist eine Genehmigung erforderlich. (Siehe [Feature-Anfragen vs. Detaillierte Feature-Vorschläge](#feature-anfragen-vs-detaillierte-feature-vorschläge) unten) - **Issues beanspruchen**: Kommentiere und warte auf die offizielle Zuweisung. **PRs ohne genehmigte Issues können geschlossen werden.** @@ -79,6 +80,46 @@ Alle Beiträge müssen mit einem GitHub Issue beginnen. - 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). +### Feature-Anfragen vs. Detaillierte Feature-Vorschläge + +Das Verständnis des Unterschieds zwischen diesen beiden Einreichungstypen ist entscheidend für die Wahl des richtigen Ansatzes: + +#### Feature-Anfrage (GitHub Discussions) + +**Zweck**: Allgemeine Ideen oder Vorschläge ohne detaillierte Planung teilen. + +**Wie einreichen**: + +- Navigiere zu [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- Oder klicke auf den "Feature Request"-Link, wenn du den "New Issue"-Button im Issues-Bereich drückst + +**Verwende dies wenn**: + +- Deine Idee noch nicht vollständig ausgearbeitet ist +- Du Community-Input oder Feedback möchtest +- Du Ideen vorschlägst, ohne sie persönlich umsetzen zu wollen + +#### Detaillierter Feature-Vorschlag (GitHub Issues) + +**Zweck**: Klar umrissene Features, die nach Genehmigung sofort umgesetzt werden sollen. + +**Wie einreichen**: + +- Navigiere zu [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Klicke auf "New Issue" und wähle die "Detailed Feature Proposal"-Vorlage + +**Verwende dies wenn**: + +- Dein Feature vollständig durchdacht und bereit für die Genehmigung ist +- Du oder jemand anderes beabsichtigt, das Feature bald umzusetzen +- Eine formelle Genehmigung vor Entwicklungsbeginn benötigt wird + +**Hinweis**: Detaillierte Feature-Vorschläge müssen von einem Maintainer genehmigt und zugewiesen werden, bevor mit der Implementierung begonnen wird, wie im obigen Abschnitt [Issue-First-Ansatz](#issue-first-ansatz) erwähnt. + +![Issue-Vorlagen-Auswahl](placeholder-for-issue-template-selection-image) + +**Wichtig**: Die Wahl der falschen Vorlage kann dazu führen, dass deine Einreichung umgeleitet oder geschlossen wird. Verwende keine Bug-Reports für Feature-Ideen. + ## Entwicklung & Einreichung ### Entwicklungs-Setup diff --git a/locales/es/CONTRIBUTING.md b/locales/es/CONTRIBUTING.md index 0b0bac01f9..49e1993394 100644 --- a/locales/es/CONTRIBUTING.md +++ b/locales/es/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code es un proyecto impulsado por la comunidad, y valoramos profundamente ca - [Antes de Contribuir](#antes-de-contribuir) - [Encontrar y Planificar tu Contribución](#encontrar-y-planificar-tu-contribución) + - [Solicitudes de Funciones vs. Propuestas Detalladas de Funciones](#solicitudes-de-funciones-vs-propuestas-detalladas-de-funciones) - [Proceso de Desarrollo y Envío](#proceso-de-desarrollo-y-envío) - [Legal](#legal) @@ -63,7 +64,7 @@ Todas las contribuciones deben comenzar con un Issue de GitHub. - **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. + - **Funciones:** Plantilla "Detailed Feature Proposal". Se requiere aprobación antes de comenzar. (Ver [Solicitudes de Funciones vs. Propuestas Detalladas de Funciones](#solicitudes-de-funciones-vs-propuestas-detalladas-de-funciones) abajo) - **Reclamar issues**: Comenta y espera la asignación oficial. **Los PRs sin issues aprobados pueden ser cerrados.** @@ -79,6 +80,46 @@ Todas las contribuciones deben comenzar con un Issue de GitHub. - 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). +### Solicitudes de Funciones vs. Propuestas Detalladas de Funciones + +Comprender la diferencia entre estos dos tipos de envío es crucial para elegir el enfoque correcto: + +#### Solicitud de Función (GitHub Discussions) + +**Propósito**: Compartir ideas o sugerencias generales sin planificación detallada. + +**Cómo enviar**: + +- Navega a [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- O haz clic en el enlace "Feature Request" al presionar el botón "New Issue" en la sección de issues + +**Usa esto cuando**: + +- Tu idea aún no está completamente desarrollada +- Quieres comentarios o retroalimentación de la comunidad +- Estás proponiendo ideas sin planes de implementarlas personalmente + +#### Propuesta Detallada de Función (GitHub Issues) + +**Propósito**: Funciones claramente delineadas destinadas a implementación inmediata después de la aprobación. + +**Cómo enviar**: + +- Navega a [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Haz clic en "New Issue" y selecciona la plantilla "Detailed Feature Proposal" + +**Usa esto cuando**: + +- Tu función está completamente planificada y lista para aprobación +- Tú o alguien más tiene la intención de implementar la función pronto +- Se necesita aprobación formal antes de comenzar el desarrollo + +**Nota**: Las Propuestas Detalladas de Funciones deben ser aprobadas y asignadas por un mantenedor antes de comenzar la implementación, como se menciona en la sección [Enfoque Issue-First](#enfoque-issue-first) anterior. + +![Selección de Plantilla de Issue](placeholder-for-issue-template-selection-image) + +**Importante**: Elegir la plantilla incorrecta puede hacer que tu envío sea redirigido o cerrado. No uses Reportes de Errores para ideas de funciones. + ## Proceso de Desarrollo y Envío ### Configuración de Desarrollo diff --git a/locales/fr/CONTRIBUTING.md b/locales/fr/CONTRIBUTING.md index 0e14cdcca1..b3ec54c013 100644 --- a/locales/fr/CONTRIBUTING.md +++ b/locales/fr/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code est un projet porté par la communauté, et chaque contribution compte - [Avant de contribuer](#avant-de-contribuer) - [Trouver et planifier ta contribution](#trouver-et-planifier-ta-contribution) + - [Demandes de fonctionnalités vs. Propositions détaillées de fonctionnalités](#demandes-de-fonctionnalités-vs-propositions-détaillées-de-fonctionnalités) - [Processus de développement et de soumission](#processus-de-développement-et-de-soumission) - [Légal](#légal) @@ -63,7 +64,7 @@ Toutes les contributions doivent commencer par un ticket GitHub. - **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. + - **Fonctionnalités :** Modèle "Detailed Feature Proposal". Approbation requise avant de commencer. (Voir [Demandes de fonctionnalités vs. Propositions détaillées de fonctionnalités](#demandes-de-fonctionnalités-vs-propositions-détaillées-de-fonctionnalités) ci-dessous) - **Réclamer des tickets :** Commente et attends l'assignation officielle. **Les PRs sans tickets approuvés peuvent être fermées.** @@ -79,6 +80,46 @@ Toutes les contributions doivent commencer par un ticket GitHub. - 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). +### Demandes de fonctionnalités vs. Propositions détaillées de fonctionnalités + +Comprendre la différence entre ces deux types de soumission est crucial pour choisir la bonne approche : + +#### Demande de fonctionnalité (GitHub Discussions) + +**Objectif** : Partager des idées ou suggestions générales sans planification détaillée. + +**Comment soumettre** : + +- Navigue vers [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- Ou clique sur le lien "Feature Request" en appuyant sur le bouton "New Issue" dans la section issues + +**Utilise ceci quand** : + +- Ton idée n'est pas encore entièrement développée +- Tu souhaites des commentaires ou du feedback de la communauté +- Tu proposes des idées sans avoir l'intention de les implémenter personnellement + +#### Proposition détaillée de fonctionnalité (GitHub Issues) + +**Objectif** : Fonctionnalités clairement définies destinées à une implémentation immédiate après approbation. + +**Comment soumettre** : + +- Navigue vers [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Clique sur "New Issue" et sélectionne le modèle "Detailed Feature Proposal" + +**Utilise ceci quand** : + +- Ta fonctionnalité est entièrement planifiée et prête pour l'approbation +- Toi ou quelqu'un d'autre a l'intention d'implémenter la fonctionnalité bientôt +- Une approbation formelle est nécessaire avant de commencer le développement + +**Note** : Les Propositions détaillées de fonctionnalités doivent être approuvées et assignées par un mainteneur avant de commencer l'implémentation, comme mentionné dans la section [Approche Issue-First](#approche-issue-first) ci-dessus. + +![Sélection du modèle d'issue](placeholder-for-issue-template-selection-image) + +**Important** : Choisir le mauvais modèle peut entraîner la redirection ou la fermeture de ta soumission. N'utilise pas les rapports de bugs pour des idées de fonctionnalités. + ## Processus de développement et de soumission ### Configuration du développement diff --git a/locales/hi/CONTRIBUTING.md b/locales/hi/CONTRIBUTING.md index 17d62e1794..81116bdcc6 100644 --- a/locales/hi/CONTRIBUTING.md +++ b/locales/hi/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code एक समुदाय-आधारित प्रोजेक् - [योगदान करने से पहले](#योगदान-करने-से-पहले) - [अपना योगदान ढूंढना और योजना बनाना](#अपना-योगदान-ढूंढना-और-योजना-बनाना) + - [फीचर अनुरोध बनाम विस्तृत फीचर प्रस्ताव](#फीचर-अनुरोध-बनाम-विस्तृत-फीचर-प्रस्ताव) - [विकास और सबमिशन प्रक्रिया](#विकास-और-सबमिशन-प्रक्रिया) - [कानूनी](#कानूनी) @@ -63,7 +64,7 @@ Roo Code एक समुदाय-आधारित प्रोजेक् - **मौजूदा Issues देखें:** [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) में खोजें। - **Issue बनाएं:** उपयुक्त टेम्पलेट का उपयोग करें: - **बग:** "Bug Report" टेम्पलेट। - - **फीचर्स:** "Detailed Feature Proposal" टेम्पलेट। शुरू करने से पहले अनुमोदन आवश्यक है। + - **फीचर्स:** "Detailed Feature Proposal" टेम्पलेट। शुरू करने से पहले अनुमोदन आवश्यक है। (नीचे [फीचर अनुरोध बनाम विस्तृत फीचर प्रस्ताव](#फीचर-अनुरोध-बनाम-विस्तृत-फीचर-प्रस्ताव) देखें) - **Issue क्लेम करें:** कमेंट करें और आधिकारिक असाइनमेंट का इंतजार करें। **अनुमोदित Issue के बिना PR बंद किए जा सकते हैं।** @@ -79,6 +80,46 @@ Roo Code एक समुदाय-आधारित प्रोजेक् - ["Bug Report" टेम्पलेट](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) का उपयोग करके नए बग रिपोर्ट बनाएं। - **सुरक्षा कमजोरियां:** [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new) के माध्यम से निजी तौर पर रिपोर्ट करें। +### फीचर अनुरोध बनाम विस्तृत फीचर प्रस्ताव + +इन दो सबमिशन प्रकारों के बीच अंतर को समझना सही दृष्टिकोण चुनने के लिए महत्वपूर्ण है: + +#### फीचर अनुरोध (GitHub Discussions) + +**उद्देश्य**: विस्तृत योजना के बिना सामान्य विचार या सुझाव साझा करना। + +**कैसे सबमिट करें**: + +- [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) पर जाएं +- या issues सेक्शन में "New Issue" बटन दबाते समय "Feature Request" लिंक पर क्लिक करें + +**इसका उपयोग कब करें**: + +- आपका विचार अभी पूरी तरह से विकसित नहीं है +- आप समुदाय से इनपुट या फीडबैक चाहते हैं +- आप व्यक्तिगत रूप से उन्हें लागू करने की योजना के बिना विचार प्रस्तावित कर रहे हैं + +#### विस्तृत फीचर प्रस्ताव (GitHub Issues) + +**उद्देश्य**: अनुमोदन के बाद तत्काल कार्यान्वयन के लिए स्पष्ट रूप से रेखांकित फीचर। + +**कैसे सबमिट करें**: + +- [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) पर जाएं +- "New Issue" पर क्लिक करें और "Detailed Feature Proposal" टेम्पलेट चुनें + +**इसका उपयोग कब करें**: + +- आपका फीचर पूरी तरह से योजनाबद्ध है और अनुमोदन के लिए तैयार है +- आप या कोई और जल्द ही फीचर को लागू करने का इरादा रखता है +- विकास शुरू करने से पहले औपचारिक अनुमोदन की आवश्यकता है + +**नोट**: विस्तृत फीचर प्रस्तावों को कार्यान्वयन शुरू करने से पहले एक मेंटेनर द्वारा अनुमोदित और असाइन किया जाना चाहिए, जैसा कि ऊपर [Issue-First एप्रोच](#issue-first-एप्रोच) सेक्शन में उल्लेख किया गया है। + +![Issue टेम्पलेट चयन](placeholder-for-issue-template-selection-image) + +**महत्वपूर्ण**: गलत टेम्पलेट चुनने से आपका सबमिशन रीडायरेक्ट या बंद हो सकता है। फीचर विचारों के लिए बग रिपोर्ट का उपयोग न करें। + ## विकास और सबमिशन प्रक्रिया ### विकास सेटअप diff --git a/locales/it/CONTRIBUTING.md b/locales/it/CONTRIBUTING.md index e83802eb31..5224f05e29 100644 --- a/locales/it/CONTRIBUTING.md +++ b/locales/it/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code è un progetto guidato dalla community e apprezziamo molto ogni contrib - [Prima di contribuire](#prima-di-contribuire) - [Trovare e pianificare il tuo contributo](#trovare-e-pianificare-il-tuo-contributo) + - [Richieste di funzionalità vs. Proposte dettagliate di funzionalità](#richieste-di-funzionalità-vs-proposte-dettagliate-di-funzionalità) - [Processo di sviluppo e invio](#processo-di-sviluppo-e-invio) - [Legale](#legale) @@ -63,7 +64,7 @@ Tutti i contributi devono iniziare con una Issue GitHub. - **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. + - **Funzionalità:** Template "Detailed Feature Proposal". Approvazione richiesta prima di iniziare. (Vedi [Richieste di funzionalità vs. Proposte dettagliate di funzionalità](#richieste-di-funzionalità-vs-proposte-dettagliate-di-funzionalità) sotto) - **Reclamare issue:** Commenta e attendi l'assegnazione ufficiale. **Le PR senza issue approvate potrebbero essere chiuse.** @@ -79,6 +80,46 @@ Tutti i contributi devono iniziare con una Issue GitHub. - 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). +### Richieste di funzionalità vs. Proposte dettagliate di funzionalità + +Comprendere la differenza tra questi due tipi di invio è cruciale per scegliere l'approccio giusto: + +#### Richiesta di funzionalità (GitHub Discussions) + +**Scopo**: Condividere idee o suggerimenti generali senza pianificazione dettagliata. + +**Come inviare**: + +- Naviga su [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- O clicca sul link "Feature Request" quando premi il pulsante "New Issue" nella sezione issue + +**Usa questo quando**: + +- La tua idea non è ancora completamente sviluppata +- Vuoi input o feedback dalla community +- Stai proponendo idee senza piani di implementarle personalmente + +#### Proposta dettagliata di funzionalità (GitHub Issues) + +**Scopo**: Funzionalità chiaramente delineate destinate all'implementazione immediata dopo l'approvazione. + +**Come inviare**: + +- Naviga su [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Clicca su "New Issue" e seleziona il template "Detailed Feature Proposal" + +**Usa questo quando**: + +- La tua funzionalità è completamente pianificata e pronta per l'approvazione +- Tu o qualcun altro intende implementare la funzionalità presto +- È necessaria l'approvazione formale prima di iniziare lo sviluppo + +**Nota**: Le Proposte dettagliate di funzionalità devono essere approvate e assegnate da un maintainer prima di iniziare l'implementazione, come menzionato nella sezione [Approccio Issue-First](#approccio-issue-first) sopra. + +![Selezione del template Issue](placeholder-for-issue-template-selection-image) + +**Importante**: Scegliere il template sbagliato potrebbe portare al reindirizzamento o alla chiusura del tuo invio. Non usare i Report di Bug per idee di funzionalità. + ## Processo di sviluppo e invio ### Configurazione dello sviluppo diff --git a/locales/ja/CONTRIBUTING.md b/locales/ja/CONTRIBUTING.md index a7fdb9a8f4..80bf5ab455 100644 --- a/locales/ja/CONTRIBUTING.md +++ b/locales/ja/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code はコミュニティ主導のプロジェクトであり、すべて - [貢献する前に](#貢献する前に) - [貢献内容の発見と計画](#貢献内容の発見と計画) + - [機能リクエスト vs. 詳細な機能提案](#機能リクエスト-vs-詳細な機能提案) - [開発と提出のプロセス](#開発と提出のプロセス) - [法的事項](#法的事項) @@ -63,7 +64,7 @@ PRでこれらの領域との関連性に言及してください。 - **既存Issueの確認:** [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)を検索。 - **Issueの作成:** 適切なテンプレートを使用: - **バグ:** 「Bug Report」テンプレート。 - - **機能:** 「Detailed Feature Proposal」テンプレート。開始前に承認が必要。 + - **機能:** 「Detailed Feature Proposal」テンプレート。開始前に承認が必要。(下記の[機能リクエスト vs. 詳細な機能提案](#機能リクエスト-vs-詳細な機能提案)を参照) - **Issue担当表明:** コメントし、正式な割り当てを待つ。 **承認されたIssueに紐付けられていないPRは閉じられる可能性があります。** @@ -79,6 +80,46 @@ PRでこれらの領域との関連性に言及してください。 - 新しいバグは[「Bug Report」テンプレート](https://github.com/RooCodeInc/Roo-Code/issues/new/choose)で報告。 - **セキュリティ問題:** [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new)を通じて非公開で報告。 +### 機能リクエスト vs. 詳細な機能提案 + +これら2つの提出タイプの違いを理解することは、適切なアプローチを選択するために重要です: + +#### 機能リクエスト(GitHub Discussions) + +**目的**:詳細な計画なしに一般的なアイデアや提案を共有する。 + +**提出方法**: + +- [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests)へ移動 +- またはissuesセクションで「New Issue」ボタンを押す際に「Feature Request」リンクをクリック + +**使用する場合**: + +- アイデアがまだ完全に開発されていない +- コミュニティからの意見やフィードバックが欲しい +- 個人的に実装する予定なしにアイデアを提案している + +#### 詳細な機能提案(GitHub Issues) + +**目的**:承認後すぐに実装を意図した、明確に概説された機能。 + +**提出方法**: + +- [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)へ移動 +- 「New Issue」をクリックし、「Detailed Feature Proposal」テンプレートを選択 + +**使用する場合**: + +- 機能が完全に計画され、承認の準備ができている +- あなたまたは他の誰かがすぐに機能を実装する意図がある +- 開発開始前に正式な承認が必要 + +**注意**:詳細な機能提案は、上記の[Issue-First アプローチ](#issue-first-アプローチ)セクションで述べられているように、実装を開始する前にメンテナーによって承認され、割り当てられる必要があります。 + +![Issueテンプレート選択](placeholder-for-issue-template-selection-image) + +**重要**:間違ったテンプレートを選択すると、提出がリダイレクトまたはクローズされる可能性があります。機能のアイデアにバグレポートを使用しないでください。 + ## 開発と提出のプロセス ### 開発環境のセットアップ diff --git a/locales/ko/CONTRIBUTING.md b/locales/ko/CONTRIBUTING.md index 3588a10506..7e1792ef8b 100644 --- a/locales/ko/CONTRIBUTING.md +++ b/locales/ko/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code는 커뮤니티 주도의 프로젝트이며, 모든 기여를 소중 - [기여 전 준비](#기여-전-준비) - [기여 내용 찾기 및 계획 세우기](#기여-내용-찾기-및-계획-세우기) + - [기능 요청 vs. 상세 기능 제안](#기능-요청-vs-상세-기능-제안) - [개발 및 제출 프로세스](#개발-및-제출-프로세스) - [법적 안내](#법적-안내) @@ -63,7 +64,7 @@ PR에서 이러한 영역과의 연관성을 언급하세요. - **기존 Issue 확인:** [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)를 검색하세요. - **Issue 생성:** 적절한 템플릿 사용: - **버그:** "Bug Report" 템플릿. - - **기능:** "Detailed Feature Proposal" 템플릿. 시작 전 승인 필요. + - **기능:** "Detailed Feature Proposal" 템플릿. 시작 전 승인 필요. (아래 [기능 요청 vs. 상세 기능 제안](#기능-요청-vs-상세-기능-제안) 참조) - **Issue 담당:** 댓글을 달고 공식 할당을 기다리세요. **승인된 Issue 없는 PR은 닫힐 수 있습니다.** @@ -79,6 +80,46 @@ PR에서 이러한 영역과의 연관성을 언급하세요. - ["Bug Report" 템플릿](https://github.com/RooCodeInc/Roo-Code/issues/new/choose)을 사용하여 새 버그를 신고하세요. - **보안 문제:** [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new)를 통해 비공개로 신고하세요. +### 기능 요청 vs. 상세 기능 제안 + +이 두 제출 유형의 차이를 이해하는 것은 올바른 접근 방식을 선택하는 데 중요합니다: + +#### 기능 요청 (GitHub Discussions) + +**목적**: 상세한 계획 없이 일반적인 아이디어나 제안을 공유합니다. + +**제출 방법**: + +- [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests)로 이동 +- 또는 issues 섹션에서 "New Issue" 버튼을 누를 때 "Feature Request" 링크를 클릭 + +**사용 시기**: + +- 아이디어가 아직 완전히 개발되지 않았을 때 +- 커뮤니티의 의견이나 피드백을 원할 때 +- 개인적으로 구현할 계획 없이 아이디어를 제안할 때 + +#### 상세 기능 제안 (GitHub Issues) + +**목적**: 승인 후 즉시 구현을 위한 명확하게 개요가 작성된 기능입니다. + +**제출 방법**: + +- [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)로 이동 +- "New Issue"를 클릭하고 "Detailed Feature Proposal" 템플릿을 선택 + +**사용 시기**: + +- 기능이 완전히 계획되고 승인 준비가 되었을 때 +- 본인이나 다른 사람이 곧 기능을 구현할 의도가 있을 때 +- 개발 시작 전에 공식 승인이 필요할 때 + +**참고**: 상세 기능 제안은 위의 [Issue-First 접근법](#issue-first-접근법) 섹션에서 언급한 대로 구현을 시작하기 전에 메인테이너의 승인과 할당이 필요합니다. + +![Issue 템플릿 선택](placeholder-for-issue-template-selection-image) + +**중요**: 잘못된 템플릿을 선택하면 제출이 리디렉션되거나 닫힐 수 있습니다. 기능 아이디어에 버그 리포트를 사용하지 마세요. + ## 개발 및 제출 프로세스 ### 개발 환경 설정 diff --git a/locales/nl/CONTRIBUTING.md b/locales/nl/CONTRIBUTING.md index 7665efe9f9..ab60d16d70 100644 --- a/locales/nl/CONTRIBUTING.md +++ b/locales/nl/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code is een door de community gedreven project en we waarderen elke bijdrage - [Voordat je bijdraagt](#voordat-je-bijdraagt) - [Je bijdrage vinden & plannen](#je-bijdrage-vinden--plannen) + - [Functieverzoeken vs. Gedetailleerde functievoorstellen](#functieverzoeken-vs-gedetailleerde-functievoorstellen) - [Ontwikkelings- & indieningsproces](#ontwikkelings--indieningsproces) - [Juridisch](#juridisch) @@ -63,7 +64,7 @@ Elke bijdrage moet beginnen met een GitHub Issue. - **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. + - **Functies:** "Detailed Feature Proposal"-template. Goedkeuring vereist voor je begint. (Zie [Functieverzoeken vs. Gedetailleerde functievoorstellen](#functieverzoeken-vs-gedetailleerde-functievoorstellen) hieronder) - **Issues claimen:** Reageer en wacht op officiële toewijzing. **PR's zonder goedgekeurde issues kunnen worden gesloten.** @@ -79,6 +80,46 @@ Elke bijdrage moet beginnen met een GitHub Issue. - 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). +### Functieverzoeken vs. Gedetailleerde functievoorstellen + +Het begrijpen van het verschil tussen deze twee inzendingstypes is cruciaal voor het kiezen van de juiste aanpak: + +#### Functieverzoek (GitHub Discussions) + +**Doel**: Algemene ideeën of suggesties delen zonder gedetailleerde planning. + +**Hoe in te dienen**: + +- Navigeer naar [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- Of klik op de "Feature Request"-link wanneer je op de "New Issue"-knop drukt in de issues-sectie + +**Gebruik dit wanneer**: + +- Je idee nog niet volledig is uitgewerkt +- Je community-input of feedback wilt +- Je ideeën voorstelt zonder plannen om ze persoonlijk te implementeren + +#### Gedetailleerd functievoorstel (GitHub Issues) + +**Doel**: Duidelijk omschreven functies bedoeld voor onmiddellijke implementatie na goedkeuring. + +**Hoe in te dienen**: + +- Navigeer naar [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Klik op "New Issue" en selecteer de "Detailed Feature Proposal"-template + +**Gebruik dit wanneer**: + +- Je functie volledig is uitgedacht en klaar is voor goedkeuring +- Jij of iemand anders van plan is de functie binnenkort te implementeren +- Formele goedkeuring nodig is voordat de ontwikkeling begint + +**Opmerking**: Gedetailleerde functievoorstellen moeten worden goedgekeurd en toegewezen door een maintainer voordat met de implementatie wordt begonnen, zoals vermeld in de sectie [Issue-First-aanpak](#issue-first-aanpak) hierboven. + +![Issue Template Selectie](placeholder-for-issue-template-selection-image) + +**Belangrijk**: Het kiezen van de verkeerde template kan ertoe leiden dat je inzending wordt omgeleid of gesloten. Gebruik geen Bug Reports voor functie-ideeën. + ## Ontwikkelings- & indieningsproces ### Ontwikkelomgeving instellen diff --git a/locales/pl/CONTRIBUTING.md b/locales/pl/CONTRIBUTING.md index 3005dc4c90..e1707e53f2 100644 --- a/locales/pl/CONTRIBUTING.md +++ b/locales/pl/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code to projekt napędzany przez społeczność i bardzo cenimy każdy wkła - [Zanim zaczniesz współtworzyć](#zanim-zaczniesz-współtworzyć) - [Znajdowanie i planowanie swojego wkładu](#znajdowanie-i-planowanie-swojego-wkładu) + - [Prośby o funkcje vs. Szczegółowe propozycje funkcji](#prośby-o-funkcje-vs-szczegółowe-propozycje-funkcji) - [Proces rozwoju i zgłaszania](#proces-rozwoju-i-zgłaszania) - [Prawne](#prawne) @@ -63,7 +64,7 @@ Każdy wkład musi zaczynać się od GitHub Issue. - **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. + - **Funkcje:** Szablon "Detailed Feature Proposal". Wymagane zatwierdzenie przed rozpoczęciem. (Zobacz [Prośby o funkcje vs. Szczegółowe propozycje funkcji](#prośby-o-funkcje-vs-szczegółowe-propozycje-funkcji) poniżej) - **Zgłoś chęć pracy:** Skomentuj i poczekaj na oficjalne przypisanie. **PR bez zatwierdzonego issue może zostać zamknięty.** @@ -79,6 +80,46 @@ Każdy wkład musi zaczynać się od GitHub Issue. - 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). +### Prośby o funkcje vs. Szczegółowe propozycje funkcji + +Zrozumienie różnicy między tymi dwoma typami zgłoszeń jest kluczowe dla wyboru właściwego podejścia: + +#### Prośba o funkcję (GitHub Discussions) + +**Cel**: Dzielenie się ogólnymi pomysłami lub sugestiami bez szczegółowego planowania. + +**Jak zgłosić**: + +- Przejdź do [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- Lub kliknij link "Feature Request" po naciśnięciu przycisku "New Issue" w sekcji issues + +**Użyj tego gdy**: + +- Twój pomysł nie jest jeszcze w pełni rozwinięty +- Chcesz uzyskać opinię lub feedback społeczności +- Proponujesz pomysły bez planów osobistej implementacji + +#### Szczegółowa propozycja funkcji (GitHub Issues) + +**Cel**: Jasno określone funkcje przeznaczone do natychmiastowej implementacji po zatwierdzeniu. + +**Jak zgłosić**: + +- Przejdź do [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Kliknij "New Issue" i wybierz szablon "Detailed Feature Proposal" + +**Użyj tego gdy**: + +- Twoja funkcja jest w pełni zaplanowana i gotowa do zatwierdzenia +- Ty lub ktoś inny zamierza wkrótce zaimplementować funkcję +- Potrzebne jest formalne zatwierdzenie przed rozpoczęciem rozwoju + +**Uwaga**: Szczegółowe propozycje funkcji muszą być zatwierdzone i przypisane przez maintainera przed rozpoczęciem implementacji, jak wspomniano w sekcji [Podejście Issue-First](#podejście-issue-first) powyżej. + +![Wybór szablonu Issue](placeholder-for-issue-template-selection-image) + +**Ważne**: Wybór niewłaściwego szablonu może spowodować przekierowanie lub zamknięcie twojego zgłoszenia. Nie używaj raportów błędów do pomysłów na funkcje. + ## Proces rozwoju i zgłaszania ### Konfiguracja środowiska diff --git a/locales/pt-BR/CONTRIBUTING.md b/locales/pt-BR/CONTRIBUTING.md index 91081b0f5a..3d9487b8e3 100644 --- a/locales/pt-BR/CONTRIBUTING.md +++ b/locales/pt-BR/CONTRIBUTING.md @@ -10,6 +10,7 @@ O Roo Code é um projeto impulsionado pela comunidade e valorizamos muito cada c - [Antes de Contribuir](#antes-de-contribuir) - [Encontrando & Planejando sua Contribuição](#encontrando--planejando-sua-contribuição) + - [Solicitações de Recursos vs. Propostas Detalhadas de Recursos](#solicitações-de-recursos-vs-propostas-detalhadas-de-recursos) - [Processo de Desenvolvimento & Submissão](#processo-de-desenvolvimento--submissão) - [Legal](#legal) @@ -63,7 +64,7 @@ Todas as contribuições devem começar com uma Issue do GitHub. - **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. + - **Recursos:** Template "Detailed Feature Proposal". Aprovação necessária antes de começar. (Veja [Solicitações de Recursos vs. Propostas Detalhadas de Recursos](#solicitações-de-recursos-vs-propostas-detalhadas-de-recursos) abaixo) - **Reivindicar issues:** Comente e aguarde atribuição oficial. **PRs sem issues aprovadas podem ser fechados.** @@ -79,6 +80,46 @@ Todas as contribuições devem começar com uma Issue do GitHub. - 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). +### Solicitações de Recursos vs. Propostas Detalhadas de Recursos + +Entender a diferença entre esses dois tipos de submissão é crucial para escolher a abordagem correta: + +#### Solicitação de Recurso (GitHub Discussions) + +**Propósito**: Compartilhar ideias ou sugestões gerais sem planejamento detalhado. + +**Como enviar**: + +- Navegue para [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- Ou clique no link "Feature Request" ao pressionar o botão "New Issue" na seção de issues + +**Use isso quando**: + +- Sua ideia ainda não está totalmente desenvolvida +- Você quer input ou feedback da comunidade +- Você está propondo ideias sem planos de implementá-las pessoalmente + +#### Proposta Detalhada de Recurso (GitHub Issues) + +**Propósito**: Recursos claramente delineados destinados à implementação imediata após aprovação. + +**Como enviar**: + +- Navegue para [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Clique em "New Issue" e selecione o template "Detailed Feature Proposal" + +**Use isso quando**: + +- Seu recurso está completamente planejado e pronto para aprovação +- Você ou outra pessoa pretende implementar o recurso em breve +- Aprovação formal é necessária antes de iniciar o desenvolvimento + +**Nota**: Propostas Detalhadas de Recursos devem ser aprovadas e atribuídas por um mantenedor antes de iniciar a implementação, conforme mencionado na seção [Abordagem Issue-First](#abordagem-issue-first) acima. + +![Seleção de Template de Issue](placeholder-for-issue-template-selection-image) + +**Importante**: Escolher o template errado pode levar ao redirecionamento ou fechamento da sua submissão. Não use Relatórios de Bug para ideias de recursos. + ## Processo de Desenvolvimento & Submissão ### Configuração de Desenvolvimento diff --git a/locales/ru/CONTRIBUTING.md b/locales/ru/CONTRIBUTING.md index 155353c0ce..9f14d0ee60 100644 --- a/locales/ru/CONTRIBUTING.md +++ b/locales/ru/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code — проект, управляемый сообществом, и м - [Перед тем как внести вклад](#перед-тем-как-внести-вклад) - [Поиск и планирование вклада](#поиск-и-планирование-вклада) + - [Запросы функций vs. Детальные предложения функций](#запросы-функций-vs-детальные-предложения-функций) - [Процесс разработки и отправки](#процесс-разработки-и-отправки) - [Юридическая информация](#юридическая-информация) @@ -63,7 +64,7 @@ Roo Code — проект, управляемый сообществом, и м - **Проверь существующие issues:** Поищи в [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues). - **Создай issue:** Используй подходящие шаблоны: - **Баги:** Шаблон "Bug Report". - - **Функции:** Шаблон "Detailed Feature Proposal". Требуется одобрение перед началом. + - **Функции:** Шаблон "Detailed Feature Proposal". Требуется одобрение перед началом. (См. [Запросы функций vs. Детальные предложения функций](#запросы-функций-vs-детальные-предложения-функций) ниже) - **Заяви issue:** Оставь комментарий и дождись официального назначения. **PR без одобренных issue могут быть закрыты.** @@ -79,6 +80,46 @@ Roo Code — проект, управляемый сообществом, и м - Создай новые сообщения об ошибках, используя [шаблон "Bug Report"](https://github.com/RooCodeInc/Roo-Code/issues/new/choose). - **Уязвимости безопасности:** Сообщай приватно через [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new). +### Запросы функций vs. Детальные предложения функций + +Понимание разницы между этими двумя типами заявок крайне важно для выбора правильного подхода: + +#### Запрос функции (GitHub Discussions) + +**Цель**: Поделиться общими идеями или предложениями без детального планирования. + +**Как отправить**: + +- Перейди в [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- Или нажми на ссылку "Feature Request" при нажатии кнопки "New Issue" в разделе issues + +**Используй это когда**: + +- Твоя идея еще не полностью разработана +- Ты хочешь получить мнение или отзывы сообщества +- Ты предлагаешь идеи без планов лично их реализовывать + +#### Детальное предложение функции (GitHub Issues) + +**Цель**: Четко описанные функции, предназначенные для немедленной реализации после одобрения. + +**Как отправить**: + +- Перейди в [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Нажми "New Issue" и выбери шаблон "Detailed Feature Proposal" + +**Используй это когда**: + +- Твоя функция полностью продумана и готова к одобрению +- Ты или кто-то другой намерен вскоре реализовать функцию +- Требуется формальное одобрение перед началом разработки + +**Примечание**: Детальные предложения функций должны быть одобрены и назначены мейнтейнером перед началом реализации, как упомянуто в разделе [Подход Issue-First](#подход-issue-first) выше. + +![Выбор шаблона Issue](placeholder-for-issue-template-selection-image) + +**Важно**: Выбор неправильного шаблона может привести к перенаправлению или закрытию твоей заявки. Не используй отчеты об ошибках для идей функций. + ## Процесс разработки и отправки ### Настройка среды разработки diff --git a/locales/tr/CONTRIBUTING.md b/locales/tr/CONTRIBUTING.md index ddab3b497a..fb70c45d8d 100644 --- a/locales/tr/CONTRIBUTING.md +++ b/locales/tr/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code, topluluk odaklı bir projedir ve her katkıyı çok önemsiyoruz. İş - [Katkıdan Önce](#katkıdan-önce) - [Katkı Bulma & Planlama](#katkı-bulma--planlama) + - [Özellik İstekleri vs. Detaylı Özellik Önerileri](#özellik-istekleri-vs-detaylı-özellik-önerileri) - [Geliştirme & Gönderim Süreci](#geliştirme--gönderim-süreci) - [Yasal](#yasal) @@ -63,7 +64,7 @@ Tüm katkılar bir GitHub Issue ile başlamalıdır. - **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. + - **Özellikler:** "Detailed Feature Proposal" şablonu. Başlamadan önce onay gerekir. (Aşağıdaki [Özellik İstekleri vs. Detaylı Özellik Önerileri](#özellik-istekleri-vs-detaylı-özellik-önerileri) bölümüne bakın) - **Issue'ları sahiplen:** Yorum yap ve resmi atamayı bekle. **Onaylanmış issue'lara bağlı olmayan PR'lar kapatılabilir.** @@ -79,6 +80,46 @@ Tüm katkılar bir GitHub Issue ile başlamalıdır. - ["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. +### Özellik İstekleri vs. Detaylı Özellik Önerileri + +Bu iki gönderim türü arasındaki farkı anlamak, doğru yaklaşımı seçmek için çok önemlidir: + +#### Özellik İsteği (GitHub Discussions) + +**Amaç**: Detaylı planlama olmadan genel fikirleri veya önerileri paylaşmak. + +**Nasıl gönderilir**: + +- [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests)'e git +- Veya issues bölümünde "New Issue" düğmesine bastığında "Feature Request" bağlantısına tıkla + +**Şu durumlarda kullan**: + +- Fikrin henüz tam olarak geliştirilmemiş +- Topluluktan görüş veya geri bildirim istiyorsun +- Kişisel olarak uygulamayı planlamadan fikirler öneriyorsun + +#### Detaylı Özellik Önerisi (GitHub Issues) + +**Amaç**: Onaydan sonra hemen uygulanması amaçlanan, açıkça tanımlanmış özellikler. + +**Nasıl gönderilir**: + +- [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)'a git +- "New Issue"ya tıkla ve "Detailed Feature Proposal" şablonunu seç + +**Şu durumlarda kullan**: + +- Özelliğin tamamen planlanmış ve onay için hazır +- Sen veya başka biri özelliği yakında uygulamayı planlıyor +- Geliştirmeye başlamadan önce resmi onay gerekiyor + +**Not**: Detaylı Özellik Önerileri, yukarıdaki [Issue-First Yaklaşımı](#issue-first-yaklaşımı) bölümünde belirtildiği gibi, uygulamaya başlamadan önce bir maintainer tarafından onaylanmalı ve atanmalıdır. + +![Issue Şablon Seçimi](placeholder-for-issue-template-selection-image) + +**Önemli**: Yanlış şablonu seçmek, gönderimin yönlendirilmesine veya kapatılmasına neden olabilir. Özellik fikirleri için Hata Raporlarını kullanma. + ## Geliştirme & Gönderim Süreci ### Geliştirme Ortamı Kurulumu diff --git a/locales/vi/CONTRIBUTING.md b/locales/vi/CONTRIBUTING.md index a561615507..2a67e05a03 100644 --- a/locales/vi/CONTRIBUTING.md +++ b/locales/vi/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code là một dự án do cộng đồng dẫn dắt và chúng mình rất - [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) + - [Yêu cầu tính năng vs. Đề xuất tính năng chi tiết](#yêu-cầu-tính-năng-vs-đề-xuất-tính-năng-chi-tiết) - [Quy trình phát triển & gửi bài](#quy-trình-phát-triển--gửi-bài) - [Pháp lý](#pháp-lý) @@ -63,7 +64,7 @@ Mọi đóng góp đều phải bắt đầu bằng một GitHub Issue. - **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. + - **Tính năng:** Mẫu "Detailed Feature Proposal". Cần được phê duyệt trước khi bắt đầu. (Xem [Yêu cầu tính năng vs. Đề xuất tính năng chi tiết](#yêu-cầu-tính-năng-vs-đề-xuất-tính-năng-chi-tiết) bên dưới) - **Nhận issue:** Bình luận và chờ được gán chính thức. **PR không có issue đã duyệt có thể bị đóng.** @@ -79,6 +80,46 @@ Mọi đóng góp đều phải bắt đầu bằng một GitHub Issue. - 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). +### Yêu cầu tính năng vs. Đề xuất tính năng chi tiết + +Hiểu rõ sự khác biệt giữa hai loại gửi bài này rất quan trọng để chọn cách tiếp cận đúng: + +#### Yêu cầu tính năng (GitHub Discussions) + +**Mục đích**: Chia sẻ ý tưởng hoặc đề xuất chung mà không cần lập kế hoạch chi tiết. + +**Cách gửi**: + +- Điều hướng đến [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- Hoặc nhấp vào liên kết "Feature Request" khi nhấn nút "New Issue" trong phần issues + +**Sử dụng khi**: + +- Ý tưởng của bạn chưa được phát triển đầy đủ +- Bạn muốn nhận ý kiến hoặc phản hồi từ cộng đồng +- Bạn đang đề xuất ý tưởng mà không có kế hoạch tự mình thực hiện + +#### Đề xuất tính năng chi tiết (GitHub Issues) + +**Mục đích**: Các tính năng được phác thảo rõ ràng nhằm triển khai ngay sau khi được phê duyệt. + +**Cách gửi**: + +- Điều hướng đến [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- Nhấp vào "New Issue" và chọn mẫu "Detailed Feature Proposal" + +**Sử dụng khi**: + +- Tính năng của bạn đã được lập kế hoạch đầy đủ và sẵn sàng để phê duyệt +- Bạn hoặc người khác có ý định triển khai tính năng sớm +- Cần phê duyệt chính thức trước khi bắt đầu phát triển + +**Lưu ý**: Đề xuất tính năng chi tiết phải được phê duyệt và gán bởi người duy trì trước khi bắt đầu triển khai, như đã đề cập trong phần [Cách tiếp cận Issue-First](#cách-tiếp-cận-issue-first) ở trên. + +![Lựa chọn mẫu Issue](placeholder-for-issue-template-selection-image) + +**Quan trọng**: Chọn sai mẫu có thể khiến bài gửi của bạn bị chuyển hướng hoặc đóng. Không sử dụng Báo cáo lỗi cho ý tưởng tính năng. + ## Quy trình phát triển & gửi bài ### Thiết lập môi trường phát triển diff --git a/locales/zh-CN/CONTRIBUTING.md b/locales/zh-CN/CONTRIBUTING.md index b31f89f47b..1f681bb250 100644 --- a/locales/zh-CN/CONTRIBUTING.md +++ b/locales/zh-CN/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code 是一个由社区驱动的项目,我们高度重视每一份贡献 - [贡献前须知](#贡献前须知) - [寻找与规划你的贡献](#寻找与规划你的贡献) + - [功能请求 vs. 详细功能提案](#功能请求-vs-详细功能提案) - [开发与提交流程](#开发与提交流程) - [法律声明](#法律声明) @@ -63,7 +64,7 @@ Roo Code 是一个由社区驱动的项目,我们高度重视每一份贡献 - **检查现有 issue:** 搜索 [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)。 - **创建 issue:** 使用适当模板: - **Bug:** "Bug Report" 模板。 - - **功能:** "Detailed Feature Proposal" 模板。开始前需获得批准。 + - **功能:** "Detailed Feature Proposal" 模板。开始前需获得批准。(见下方[功能请求 vs. 详细功能提案](#功能请求-vs-详细功能提案)) - **认领 issue:** 评论并等待正式分配。 **未关联已批准 issue 的 PR 可能会被关闭。** @@ -79,6 +80,46 @@ Roo Code 是一个由社区驱动的项目,我们高度重视每一份贡献 - 使用 ["Bug Report" 模板](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) 创建新 bug 报告。 - **安全问题:** 通过 [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new) 私下报告。 +### 功能请求 vs. 详细功能提案 + +理解这两种提交类型的区别对于选择正确的方法至关重要: + +#### 功能请求(GitHub Discussions) + +**目的**:分享一般性想法或建议,无需详细规划。 + +**如何提交**: + +- 导航至 [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- 或在 issues 部分点击 "New Issue" 按钮时点击 "Feature Request" 链接 + +**使用场景**: + +- 你的想法尚未完全成型 +- 你希望获得社区的意见或反馈 +- 你提出想法但没有亲自实施的计划 + +#### 详细功能提案(GitHub Issues) + +**目的**:明确概述的功能,旨在获得批准后立即实施。 + +**如何提交**: + +- 导航至 [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- 点击 "New Issue" 并选择 "Detailed Feature Proposal" 模板 + +**使用场景**: + +- 你的功能已完全规划并准备好接受批准 +- 你或其他人打算很快实施该功能 +- 开始开发前需要正式批准 + +**注意**:详细功能提案必须在开始实施前由维护者批准和分配,如上述 [Issue-First 方式](#issue-first-方式)部分所述。 + +![Issue 模板选择](placeholder-for-issue-template-selection-image) + +**重要**:选择错误的模板可能导致你的提交被重定向或关闭。不要将 Bug 报告用于功能想法。 + ## 开发与提交流程 ### 开发环境配置 diff --git a/locales/zh-TW/CONTRIBUTING.md b/locales/zh-TW/CONTRIBUTING.md index 7a9e1c65a5..18b68fc923 100644 --- a/locales/zh-TW/CONTRIBUTING.md +++ b/locales/zh-TW/CONTRIBUTING.md @@ -10,6 +10,7 @@ Roo Code 是一個由社群驅動的專案,我們深深重視每一份貢獻 - [貢獻前須知](#貢獻前須知) - [尋找與規劃你的貢獻](#尋找與規劃你的貢獻) + - [功能請求 vs. 詳細功能提案](#功能請求-vs-詳細功能提案) - [開發與提交流程](#開發與提交流程) - [法律聲明](#法律聲明) @@ -63,7 +64,7 @@ Roo Code 是一個由社群驅動的專案,我們深深重視每一份貢獻 - **檢查現有 issue:** 搜尋 [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)。 - **建立 issue:** 使用適當範本: - **Bug:** 「Bug Report」範本。 - - **功能:** 「Detailed Feature Proposal」範本。開始前需獲得批准。 + - **功能:** 「Detailed Feature Proposal」範本。開始前需獲得批准。(見下方[功能請求 vs. 詳細功能提案](#功能請求-vs-詳細功能提案)) - **認領 issue:** 留言並等待正式分配。 **未關聯已批准 issue 的 PR 可能會被關閉。** @@ -79,6 +80,46 @@ Roo Code 是一個由社群驅動的專案,我們深深重視每一份貢獻 - 使用 [「Bug Report」範本](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) 建立新 bug 報告。 - **安全問題:** 透過 [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new) 私下回報。 +### 功能請求 vs. 詳細功能提案 + +理解這兩種提交類型的差異對於選擇正確的方法至關重要: + +#### 功能請求(GitHub Discussions) + +**目的**:分享一般性想法或建議,無需詳細規劃。 + +**如何提交**: + +- 導覽至 [GitHub Discussions - Feature Requests](https://github.com/RooCodeInc/Roo-Code/discussions/categories/feature-requests) +- 或在 issues 部分點擊「New Issue」按鈕時點擊「Feature Request」連結 + +**使用場景**: + +- 你的想法尚未完全成型 +- 你希望獲得社群的意見或回饋 +- 你提出想法但沒有親自實施的計畫 + +#### 詳細功能提案(GitHub Issues) + +**目的**:明確概述的功能,旨在獲得批准後立即實施。 + +**如何提交**: + +- 導覽至 [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues) +- 點擊「New Issue」並選擇「Detailed Feature Proposal」範本 + +**使用場景**: + +- 你的功能已完全規劃並準備好接受批准 +- 你或其他人打算很快實施該功能 +- 開始開發前需要正式批准 + +**注意**:詳細功能提案必須在開始實施前由維護者批准和分配,如上述 [Issue-First 方式](#issue-first-方式)部分所述。 + +![Issue 範本選擇](placeholder-for-issue-template-selection-image) + +**重要**:選擇錯誤的範本可能導致你的提交被重新導向或關閉。不要將 Bug 報告用於功能想法。 + ## 開發與提交流程 ### 開發環境設定