|
|
@@ -1,12 +1,12 @@
|
|
|
# Beitrag zu Roo Code
|
|
|
|
|
|
-Wir freuen uns, dass Sie Interesse haben, zu Roo Code beizutragen. Ob Sie einen Fehler beheben, eine Funktion hinzufügen oder unsere Dokumentation verbessern, jeder Beitrag macht Roo Code intelligenter! Um unsere Community lebendig und einladend zu halten, müssen sich alle Mitglieder an unseren [Verhaltenskodex](CODE_OF_CONDUCT.md) halten.
|
|
|
+Wir freuen uns, dass du Interesse hast, zu Roo Code beizutragen. Ob du einen Fehler behebst, eine Funktion hinzufügst oder unsere Dokumentation verbesserst, jeder Beitrag macht Roo Code intelligenter! Um unsere Community lebendig und einladend zu halten, müssen sich alle Mitglieder an unseren [Verhaltenskodex](CODE_OF_CONDUCT.md) halten.
|
|
|
|
|
|
## Treten Sie unserer Community bei
|
|
|
|
|
|
-Wir ermutigen alle Mitwirkenden nachdrücklich, unserer [Discord-Community](https://discord.gg/roocode) beizutreten! Teil unseres Discord-Servers zu sein, hilft Ihnen:
|
|
|
+Wir ermutigen alle Mitwirkenden nachdrücklich, unserer [Discord-Community](https://discord.gg/roocode) beizutreten! Teil unseres Discord-Servers zu sein, hilft dir:
|
|
|
|
|
|
-- Echtzeit-Hilfe und Anleitung für Ihre Beiträge zu erhalten
|
|
|
+- Echtzeit-Hilfe und Anleitung für deine Beiträge zu erhalten
|
|
|
- Mit anderen Mitwirkenden und Kernteammitgliedern in Kontakt zu treten
|
|
|
- Über Projektentwicklungen und Prioritäten auf dem Laufenden zu bleiben
|
|
|
- An Diskussionen teilzunehmen, die die Zukunft von Roo Code gestalten
|
|
|
@@ -14,46 +14,107 @@ Wir ermutigen alle Mitwirkenden nachdrücklich, unserer [Discord-Community](http
|
|
|
|
|
|
## Fehler oder Probleme melden
|
|
|
|
|
|
-Fehlerberichte helfen, Roo Code für alle besser zu machen! Bevor Sie ein neues Issue erstellen, bitte [suchen Sie in bestehenden Issues](https://github.com/RooVetGit/Roo-Code/issues), um Duplikate zu vermeiden. Wenn Sie bereit sind, einen Fehler zu melden, gehen Sie zu unserer [Issues-Seite](https://github.com/RooVetGit/Roo-Code/issues/new/choose), wo Sie eine Vorlage finden, die Ihnen beim Ausfüllen der relevanten Informationen hilft.
|
|
|
+Fehlerberichte helfen, Roo Code für alle besser zu machen! Bevor du ein neues Issue erstellst, bitte [suche in bestehenden Issues](https://github.com/RooVetGit/Roo-Code/issues), um Duplikate zu vermeiden. Wenn du bereit bist, einen Fehler zu melden, gehe zu unserer [Issues-Seite](https://github.com/RooVetGit/Roo-Code/issues/new/choose), wo du eine Vorlage findest, die dir beim Ausfüllen der relevanten Informationen hilft.
|
|
|
|
|
|
<blockquote class='warning-note'>
|
|
|
- 🔐 <b>Wichtig:</b> Wenn Sie eine Sicherheitslücke entdecken, nutzen Sie bitte das <a href="https://github.com/RooVetGit/Roo-Code/security/advisories/new">Github-Sicherheitstool, um sie privat zu melden</a>.
|
|
|
+ 🔐 <b>Wichtig:</b> Wenn du eine Sicherheitslücke entdeckst, nutze bitte das <a href="https://github.com/RooVetGit/Roo-Code/security/advisories/new">Github-Sicherheitstool, um sie privat zu melden</a>.
|
|
|
</blockquote>
|
|
|
|
|
|
## Entscheiden, woran Sie arbeiten möchten
|
|
|
|
|
|
-Suchen Sie nach einem guten ersten Beitrag? Schauen Sie sich Issues im Abschnitt "Issue [Unassigned]" unseres [Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) Github-Projekts an. Diese sind speziell für neue Mitwirkende und Bereiche ausgewählt, in denen wir Hilfe gebrauchen könnten!
|
|
|
+Suchst du nach einem guten ersten Beitrag? Schau dir Issues im Abschnitt "Issue [Unassigned]" unseres [Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) Github-Projekts an. Diese sind speziell für neue Mitwirkende und Bereiche ausgewählt, in denen wir Hilfe gebrauchen könnten!
|
|
|
|
|
|
-Wir begrüßen auch Beiträge zu unserer [Dokumentation](https://docs.roocode.com/)! Ob Sie Tippfehler korrigieren, bestehende Anleitungen verbessern oder neue Bildungsinhalte erstellen - wir würden gerne ein Community-geführtes Repository von Ressourcen aufbauen, das jedem hilft, das Beste aus Roo Code herauszuholen. Sie können auf jeder Seite auf "Edit this page" klicken, um schnell zur richtigen Stelle in Github zu gelangen, um die Datei zu bearbeiten, oder Sie können direkt zu https://github.com/RooVetGit/Roo-Code-Docs gehen.
|
|
|
+Wir begrüßen auch Beiträge zu unserer [Dokumentation](https://docs.roocode.com/)! Ob du Tippfehler korrigierst, bestehende Anleitungen verbesserst oder neue Bildungsinhalte erstellst - wir würden gerne ein Community-geführtes Repository von Ressourcen aufbauen, das jedem hilft, das Beste aus Roo Code herauszuholen. Du kannst auf jeder Seite auf "Edit this page" klicken, um schnell zur richtigen Stelle in Github zu gelangen, um die Datei zu bearbeiten, oder du kannst direkt zu https://github.com/RooVetGit/Roo-Code-Docs gehen.
|
|
|
|
|
|
-Wenn Sie an einer größeren Funktion arbeiten möchten, erstellen Sie bitte zuerst eine [Funktionsanfrage](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop), damit wir diskutieren können, ob sie mit der Vision von Roo Code übereinstimmt.
|
|
|
+Wenn du an einer größeren Funktion arbeiten möchtest, erstelle bitte zuerst eine [Funktionsanfrage](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop), damit wir diskutieren können, ob sie mit der Vision von Roo Code übereinstimmt. Du kannst auch unseren [Projekt-Fahrplan](#projekt-fahrplan) unten überprüfen, um zu sehen, ob deine Idee mit unserer strategischen Ausrichtung übereinstimmt.
|
|
|
+
|
|
|
+## Projekt-Fahrplan
|
|
|
+
|
|
|
+Roo Code hat einen klaren Entwicklungsfahrplan, der unsere Prioritäten und zukünftige Richtung leitet. Das Verständnis unseres Fahrplans kann dir helfen:
|
|
|
+
|
|
|
+- Deine Beiträge mit den Projektzielen abzustimmen
|
|
|
+- Bereiche zu identifizieren, in denen deine Expertise am wertvollsten wäre
|
|
|
+- Den Kontext hinter bestimmten Designentscheidungen zu verstehen
|
|
|
+- Inspiration für neue Funktionen zu finden, die unsere Vision unterstützen
|
|
|
+
|
|
|
+Unser aktueller Fahrplan konzentriert sich auf sechs Schlüsselsäulen:
|
|
|
+
|
|
|
+### Provider-Unterstützung
|
|
|
+
|
|
|
+Wir möchten so viele Provider wie möglich gut unterstützen:
|
|
|
+
|
|
|
+- Vielseitigere "OpenAI Compatible" Unterstützung
|
|
|
+- xAI, Microsoft Azure AI, Alibaba Cloud Qwen, IBM Watsonx, Together AI, DeepInfra, Fireworks AI, Cohere, Perplexity AI, FriendliAI, Replicate
|
|
|
+- Verbesserte Unterstützung für Ollama und LM Studio
|
|
|
+
|
|
|
+### Modell-Unterstützung
|
|
|
+
|
|
|
+Wir wollen, dass Roo mit so vielen Modellen wie möglich gut funktioniert, einschließlich lokaler Modelle:
|
|
|
+
|
|
|
+- Lokale Modellunterstützung durch benutzerdefiniertes System-Prompting und Workflows
|
|
|
+- Benchmark-Evaluierungen und Testfälle
|
|
|
+
|
|
|
+### System-Unterstützung
|
|
|
+
|
|
|
+Wir wollen, dass Roo auf jedem Computer gut läuft:
|
|
|
+
|
|
|
+- Plattformübergreifende Terminal-Integration
|
|
|
+- Starke und konsistente Unterstützung für Mac, Windows und Linux
|
|
|
+
|
|
|
+### Dokumentation
|
|
|
+
|
|
|
+Wir wollen umfassende, zugängliche Dokumentation für alle Benutzer und Mitwirkenden:
|
|
|
+
|
|
|
+- Erweiterte Benutzerhandbücher und Tutorials
|
|
|
+- Klare API-Dokumentation
|
|
|
+- Bessere Anleitung für Mitwirkende
|
|
|
+- Mehrsprachige Dokumentationsressourcen
|
|
|
+- Interaktive Beispiele und Codebeispiele
|
|
|
+
|
|
|
+### Stabilität
|
|
|
+
|
|
|
+Wir wollen die Anzahl der Fehler deutlich reduzieren und die automatisierte Testabdeckung erhöhen:
|
|
|
+
|
|
|
+- Debug-Logging-Schalter
|
|
|
+- "Maschinen-/Aufgabeninformationen" Kopier-Button zum Einsenden mit Fehler-/Support-Anfragen
|
|
|
+
|
|
|
+### Internationalisierung
|
|
|
+
|
|
|
+Wir wollen, dass Roo die Sprache aller spricht:
|
|
|
+
|
|
|
+- 我们希望 Roo Code 说每个人的语言
|
|
|
+- Queremos que Roo Code hable el idioma de todos
|
|
|
+- हम चाहते हैं कि Roo Code हर किसी की भाषा बोले
|
|
|
+- نريد أن يتحدث Roo Code لغة الجميع
|
|
|
+
|
|
|
+Wir begrüßen besonders Beiträge, die unsere Fahrplanziele voranbringen. Wenn du an etwas arbeitest, das mit diesen Säulen übereinstimmt, erwähne es bitte in deiner PR-Beschreibung.
|
|
|
|
|
|
## Entwicklungs-Setup
|
|
|
|
|
|
-1. **Klonen** Sie das Repository:
|
|
|
+1. **Klone** das Repository:
|
|
|
|
|
|
```sh
|
|
|
git clone https://github.com/RooVetGit/Roo-Code.git
|
|
|
```
|
|
|
|
|
|
-2. **Installieren Sie Abhängigkeiten**:
|
|
|
+2. **Installiere Abhängigkeiten**:
|
|
|
|
|
|
```sh
|
|
|
npm run install:all
|
|
|
```
|
|
|
|
|
|
-3. **Starten Sie die Webansicht (Vite/React-App mit HMR)**:
|
|
|
+3. **Starte die Webansicht (Vite/React-App mit HMR)**:
|
|
|
|
|
|
```sh
|
|
|
npm run dev
|
|
|
```
|
|
|
|
|
|
4. **Debugging**:
|
|
|
- Drücken Sie `F5` (oder **Ausführen** → **Debugging starten**) in VSCode, um eine neue Sitzung mit geladenem Roo Code zu öffnen.
|
|
|
+ Drücke `F5` (oder **Ausführen** → **Debugging starten**) in VSCode, um eine neue Sitzung mit geladenem Roo Code zu öffnen.
|
|
|
|
|
|
Änderungen an der Webansicht erscheinen sofort. Änderungen an der Kern-Erweiterung erfordern einen Neustart des Erweiterungs-Hosts.
|
|
|
|
|
|
-Alternativ können Sie eine .vsix-Datei erstellen und direkt in VSCode installieren:
|
|
|
+Alternativ kannst du eine .vsix-Datei erstellen und direkt in VSCode installieren:
|
|
|
|
|
|
```sh
|
|
|
npm run build
|
|
|
@@ -67,46 +128,46 @@ code --install-extension bin/roo-cline-<version>.vsix
|
|
|
|
|
|
## Code schreiben und einreichen
|
|
|
|
|
|
-Jeder kann Code zu Roo Code beitragen, aber wir bitten Sie, diese Richtlinien zu befolgen, um sicherzustellen, dass Ihre Beiträge reibungslos integriert werden können:
|
|
|
+Jeder kann Code zu Roo Code beitragen, aber wir bitten dich, diese Richtlinien zu befolgen, um sicherzustellen, dass deine Beiträge reibungslos integriert werden können:
|
|
|
|
|
|
1. **Halten Sie Pull Requests fokussiert**
|
|
|
|
|
|
- - Beschränken Sie PRs auf eine einzelne Funktion oder Fehlerbehebung
|
|
|
- - Teilen Sie größere Änderungen in kleinere, zusammenhängende PRs auf
|
|
|
- - Unterteilen Sie Änderungen in logische Commits, die unabhängig überprüft werden können
|
|
|
+ - Beschränke PRs auf eine einzelne Funktion oder Fehlerbehebung
|
|
|
+ - Teile größere Änderungen in kleinere, zusammenhängende PRs auf
|
|
|
+ - Unterteile Änderungen in logische Commits, die unabhängig überprüft werden können
|
|
|
|
|
|
2. **Codequalität**
|
|
|
|
|
|
- Alle PRs müssen CI-Prüfungen bestehen, die sowohl Linting als auch Formatierung umfassen
|
|
|
- - Beheben Sie alle ESLint-Warnungen oder -Fehler vor dem Einreichen
|
|
|
- - Reagieren Sie auf alle Rückmeldungen von Ellipsis, unserem automatisierten Code-Review-Tool
|
|
|
- - Folgen Sie TypeScript-Best-Practices und halten Sie die Typsicherheit aufrecht
|
|
|
+ - Behebe alle ESLint-Warnungen oder -Fehler vor dem Einreichen
|
|
|
+ - Reagiere auf alle Rückmeldungen von Ellipsis, unserem automatisierten Code-Review-Tool
|
|
|
+ - Folge TypeScript-Best-Practices und halte die Typsicherheit aufrecht
|
|
|
|
|
|
3. **Testen**
|
|
|
|
|
|
- - Fügen Sie Tests für neue Funktionen hinzu
|
|
|
- - Führen Sie `npm test` aus, um sicherzustellen, dass alle Tests bestanden werden
|
|
|
- - Aktualisieren Sie bestehende Tests, wenn Ihre Änderungen diese beeinflussen
|
|
|
- - Schließen Sie sowohl Unit-Tests als auch Integrationstests ein, wo angemessen
|
|
|
+ - Füge Tests für neue Funktionen hinzu
|
|
|
+ - Führe `npm test` aus, um sicherzustellen, dass alle Tests bestanden werden
|
|
|
+ - Aktualisiere bestehende Tests, wenn deine Änderungen diese beeinflussen
|
|
|
+ - Schließe sowohl Unit-Tests als auch Integrationstests ein, wo angemessen
|
|
|
|
|
|
4. **Commit-Richtlinien**
|
|
|
|
|
|
- - Schreiben Sie klare, beschreibende Commit-Nachrichten
|
|
|
- - Verweisen Sie auf relevante Issues in Commits mit #issue-nummer
|
|
|
+ - Schreibe klare, beschreibende Commit-Nachrichten
|
|
|
+ - Verweise auf relevante Issues in Commits mit #issue-nummer
|
|
|
|
|
|
5. **Vor dem Einreichen**
|
|
|
|
|
|
- - Rebasen Sie Ihren Branch auf den neuesten main-Branch
|
|
|
- - Stellen Sie sicher, dass Ihr Branch erfolgreich baut
|
|
|
- - Überprüfen Sie erneut, dass alle Tests bestanden werden
|
|
|
- - Prüfen Sie Ihre Änderungen auf Debug-Code oder Konsolenausgaben
|
|
|
+ - Rebase deinen Branch auf den neuesten main-Branch
|
|
|
+ - Stelle sicher, dass dein Branch erfolgreich baut
|
|
|
+ - Überprüfe erneut, dass alle Tests bestanden werden
|
|
|
+ - Prüfe deine Änderungen auf Debug-Code oder Konsolenausgaben
|
|
|
|
|
|
6. **Pull Request Beschreibung**
|
|
|
- - Beschreiben Sie klar, was Ihre Änderungen bewirken
|
|
|
- - Fügen Sie Schritte zum Testen der Änderungen hinzu
|
|
|
- - Listen Sie alle Breaking Changes auf
|
|
|
- - Fügen Sie Screenshots für UI-Änderungen hinzu
|
|
|
+ - Beschreibe klar, was deine Änderungen bewirken
|
|
|
+ - Füge Schritte zum Testen der Änderungen hinzu
|
|
|
+ - Liste alle Breaking Changes auf
|
|
|
+ - Füge Screenshots für UI-Änderungen hinzu
|
|
|
|
|
|
## Beitragsvereinbarung
|
|
|
|
|
|
-Durch das Einreichen eines Pull Requests stimmen Sie zu, dass Ihre Beiträge unter derselben Lizenz wie das Projekt ([Apache 2.0](../LICENSE)) lizenziert werden.
|
|
|
+Durch das Einreichen eines Pull Requests stimmst du zu, dass deine Beiträge unter derselben Lizenz wie das Projekt ([Apache 2.0](../LICENSE)) lizenziert werden.
|