|
| 1 | +# Beitrag zu Cline |
| 2 | + |
| 3 | +Wir freuen uns, dass du daran interessiert bist, zu Cline beizutragen. Ob du einen Fehler behebst, eine Funktion hinzufügst oder unsere Dokumentation verbesserst – jeder Beitrag macht Cline intelligenter! Um unsere Community lebendig und einladend zu halten, müssen alle Mitglieder unseren [Verhaltenskodex](CODE_OF_CONDUCT.md) einhalten. |
| 4 | + |
| 5 | +## Fehler oder Probleme melden |
| 6 | + |
| 7 | +Fehlermeldungen helfen, Cline für alle zu verbessern! Bevor du ein neues Problem erstellst, überprüfe bitte die [bestehenden Probleme](https://github.com/cline/cline/issues), um Duplikate zu vermeiden. Wenn du bereit bist, einen Fehler zu melden, gehe zu unserer [Issues-Seite](https://github.com/cline/cline/issues/new/choose), wo du eine Vorlage findest, die dir hilft, die relevanten Informationen auszufüllen. |
| 8 | + |
| 9 | +<blockquote class='warning-note'> |
| 10 | + 🔐 <b>Wichtig:</b> Wenn du eine Sicherheitslücke entdeckst, verwende das <a href="https://github.com/cline/cline/security/advisories/new">GitHub-Sicherheitstool, um sie privat zu melden</a>. |
| 11 | +</blockquote> |
| 12 | + |
| 13 | +## Entscheiden, woran man arbeiten möchte |
| 14 | + |
| 15 | +Suchst du nach einem guten ersten Beitrag? Schau dir die mit ["good first issue"](https://github.com/cline/cline/labels/good%20first%20issue) oder ["help wanted"](https://github.com/cline/cline/labels/help%20wanted) gekennzeichneten Issues an. Diese sind speziell für neue Mitwirkende ausgewählt und Bereiche, in denen wir gerne Hilfe erhalten würden! |
| 16 | + |
| 17 | +Wir begrüßen auch Beiträge zu unserer [Dokumentation](https://github.com/cline/cline/tree/main/docs). Ob du Tippfehler korrigierst, bestehende Anleitungen verbesserst oder neue Bildungsinhalte erstellst – wir möchten ein von der Community verwaltetes Ressourcen-Repository aufbauen, das allen hilft, das Beste aus Cline herauszuholen. Du kannst beginnen, indem du `/docs` erkundest und nach Bereichen suchst, die verbessert werden müssen. |
| 18 | + |
| 19 | +Wenn du planst, an einer größeren Funktion zu arbeiten, erstelle bitte zuerst eine [Funktionsanfrage](https://github.com/cline/cline/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop), damit wir besprechen können, ob sie mit der Vision von Cline übereinstimmt. |
| 20 | + |
| 21 | +## Entwicklungsumgebung einrichten |
| 22 | + |
| 23 | +1. **VS Code Erweiterungen** |
| 24 | + |
| 25 | + - Beim Öffnen des Projekts wird VS Code dich auffordern, die empfohlenen Erweiterungen zu installieren |
| 26 | + - Diese Erweiterungen sind für die Entwicklung erforderlich, bitte akzeptiere alle Installationsanfragen |
| 27 | + - Wenn du die Anfragen abgelehnt hast, kannst du sie manuell im Erweiterungsbereich installieren |
| 28 | + |
| 29 | +2. **Lokale Entwicklung** |
| 30 | + - Führe `npm run install:all` aus, um die Abhängigkeiten zu installieren |
| 31 | + - Führe `npm run test` aus, um die Tests lokal auszuführen |
| 32 | + - Bevor du einen PR einreichst, führe `npm run format:fix` aus, um deinen Code zu formatieren |
| 33 | + |
| 34 | +## Code schreiben und einreichen |
| 35 | + |
| 36 | +Jeder kann Code zu Cline beitragen, aber wir bitten dich, diese Richtlinien zu befolgen, um sicherzustellen, dass deine Beiträge reibungslos integriert werden: |
| 37 | + |
| 38 | +1. **Pull Requests fokussiert halten** |
| 39 | + |
| 40 | + - Begrenze PRs auf eine einzelne Funktion oder Fehlerbehebung |
| 41 | + - Teile größere Änderungen in kleinere, kohärente PRs auf |
| 42 | + - Teile Änderungen in logische Commits auf, die unabhängig überprüft werden können |
| 43 | + |
| 44 | +2. **Codequalität** |
| 45 | + |
| 46 | + - Führe `npm run lint` aus, um den Code-Stil zu überprüfen |
| 47 | + - Führe `npm run format` aus, um den Code automatisch zu formatieren |
| 48 | + - Alle PRs müssen die CI-Prüfungen bestehen, die Linting und Formatierung umfassen |
| 49 | + - Behebe alle ESLint-Warnungen oder -Fehler, bevor du einreichst |
| 50 | + - Befolge die Best Practices für TypeScript und halte die Typensicherheit ein |
| 51 | + |
| 52 | +3. **Tests** |
| 53 | + |
| 54 | + - Füge Tests für neue Funktionen hinzu |
| 55 | + - Führe `npm test` aus, um sicherzustellen, dass alle Tests bestehen |
| 56 | + - Aktualisiere bestehende Tests, wenn deine Änderungen sie beeinflussen |
| 57 | + - Füge sowohl Unit- als auch Integrationstests hinzu, wo es angebracht ist |
| 58 | + |
| 59 | +4. **Commit-Richtlinien** |
| 60 | + |
| 61 | + - Schreibe klare und beschreibende Commit-Nachrichten |
| 62 | + - Verwende das konventionelle Commit-Format (z.B. "feat:", "fix:", "docs:") |
| 63 | + - Verweise auf relevante Issues in den Commits mit #Issue-Nummer |
| 64 | + |
| 65 | +5. **Vor dem Einreichen** |
| 66 | + |
| 67 | + - Rebase deinen Branch mit dem neuesten Main |
| 68 | + - Stelle sicher, dass dein Branch korrekt gebaut wird |
| 69 | + - Überprüfe, dass alle Tests bestehen |
| 70 | + - Überprüfe deine Änderungen, um jeglichen Debug-Code oder Konsolenprotokolle zu entfernen |
| 71 | + |
| 72 | +6. **Beschreibung des Pull Requests** |
| 73 | + - Beschreibe klar, was deine Änderungen bewirken |
| 74 | + - Füge Schritte hinzu, um die Änderungen zu testen |
| 75 | + - Liste alle wichtigen Änderungen auf |
| 76 | + - Füge Screenshots für Änderungen an der Benutzeroberfläche hinzu |
| 77 | + |
| 78 | +## Beitragsvereinbarung |
| 79 | + |
| 80 | +Durch das Einreichen eines Pull Requests erklärst du dich damit einverstanden, dass deine Beiträge unter derselben Lizenz wie das Projekt ([Apache 2.0](LICENSE)) lizenziert werden. |
| 81 | + |
| 82 | +Denke daran: Zu Cline beizutragen bedeutet nicht nur, Code zu schreiben, sondern Teil einer Community zu sein, die die Zukunft der KI-gestützten Entwicklung gestaltet. Lass uns gemeinsam etwas Großartiges schaffen! 🚀 |
0 commit comments