📑 Inhaltsverzeichnis

• Beitrag zu Carch

  • Die Codebasis verstehen
  • Schritte zum Beitragen

• Beitrag zur Carch-Dokumentation

• Richtlinien

Beitrag zu Carch

Wir freuen uns, dass Sie daran interessiert sind, zu Carch beizutragen! Beiträge aller Art sind willkommen, egal ob Sie Bugs beheben, neue Features hinzufügen oder die Dokumentation verbessern. Folgen Sie diesem Leitfaden, um zu beginnen.

WARNING

Bevor Sie Beiträge leisten, öffnen Sie zunächst ein Issue im Bereich Feature Request. Wir werden dort über die Änderungen diskutieren, bevor wir mit der Implementierung fortfahren.

📌 Die Codebasis verstehen

NOTE

Bevor Sie beitragen, verstehen Sie die Struktur von Carch:

• Die Haupt-Rust-Dateien von Carch befinden sich in: src

src/
├── ui/
│   ├── app.rs
│   ├── mod.rs
│   ├── popups.rs
│   └── render.rs 
├── main.rs 
├── commands.rs
├── display.rs
├── script_list.rs 
└── version.rs

• Alle modules-Skripte sind nach Kategorien organisiert in:

modules/
├── Browser/     # Browser-bezogene Skripte
├── Desktop/     # Desktop-Umgebung-bezogene Skripte
├── Development/ # Entwicklungstools-Skripte
├── System/      # Systemkonfigurations-Skripte
└── Terminal/    # Terminal-Setup-Skripte

IMPORTANT

Zuerst analysieren Sie, wie das Skript funktioniert, bevor Sie Änderungen vornehmen. Wenn Sie das Projekt verbessern oder erweitern möchten, stellen Sie sicher, dass Sie die Struktur verstehen und wie jedes Teil interagiert. Dies wird Ihnen helfen, auf eine Weise beizutragen, die mit dem Design des Projekts konsistent ist.

Für Commits verwenden Sie Labels wie
feat: your-commit-message oder fix: your-commit-message.

Übrigens, bevor du einen Commit machst, falls du eine .sh- oder Bash-Skript-Datei änderst, überprüfe unbedingt das Verzeichnis scripts/ und führe ./check.sh aus, um überflüssige Leer- oder Leerzeilen zu finden. Falls es fehlschlägt, führe ./cleanup.sh aus. Stelle außerdem sicher, dass alle Shell-Skripte mit shfmt formatiert sind. Bei Änderungen an Rust-Dateien stelle sicher, dass du cargo fmt --all --check ausführst. Wenn es Vorschläge gibt, führe cargo fmt --all aus.
Führe außerdem cargo clippy und cargo clippy -- -Dwarnings aus, um sicherzustellen, dass keine Fehler übrig sind. Danke.

Für weitere Informationen über Conventional Commits, siehe diesen Leitfaden.

Wenn Sie Fragen haben oder Hilfe benötigen, zögern Sie nicht, uns zu kontaktieren:
📧 E-Mail: [email protected]
💬 Discord: Hier beitreten

Schritte zum Beitragen

1. 🍽️ Repository forken

• Gehen Sie zur Carch GitHub-Seite.
• Klicken Sie auf die Fork-Schaltfläche in der oberen rechten Ecke, um Ihre eigene Kopie des Repositories zu erstellen.

2. 🌿 Das geforkte Repository klonen

• Verwenden Sie den folgenden Befehl, um das Repository auf Ihr lokales System zu klonen:

  git clone https://github.com/your-username/carch.git

• Ersetzen Sie your-username durch Ihren GitHub-Benutzernamen.

💡 TIP

Sie können auch GUI-Tools wie GitHub Desktop oder sogar die GitHub-Web-Oberfläche verwenden, um Repositories zu forken und zu klonen. Diese Tools bieten eine benutzerfreundliche visuelle Oberfläche für die Verwaltung Ihrer Beiträge.

3. 🌱 Das ursprüngliche Repository als Upstream setzen

• Fügen Sie das ursprüngliche Carch-Repository als Upstream-Remote hinzu, um Ihren Fork aktuell zu halten:

  cd carch

  git remote add upstream https://github.com/original-author/carch.git

4. 🍇 Einen neuen Feature-Branch erstellen

• Bevor Sie Änderungen vornehmen, erstellen Sie einen neuen Branch mit einem beschreibenden Namen:

  git checkout -b feature/your-branch-name

• Beispiele für Branch-Namen:

  • feature/add-new-script
  • bugfix/fix-installation-issue

5. 🔧 Ihre Änderungen vornehmen

• Implementieren Sie die notwendigen Änderungen am Code oder der Dokumentation.
• Stellen Sie sicher, dass Ihre Änderungen klar, getestet und den Coding-Standards des Projekts entsprechend sind.

6. 📝 Ihre Änderungen stagen und committen

• Fügen Sie die geänderten Dateien zur Staging-Area hinzu:

  git add .

• Committen Sie Ihre Änderungen mit einer klaren Nachricht:

  git commit -m "Add: [kurze Beschreibung Ihrer Änderungen]"

7. 🚀 Die Änderungen zu Ihrem Fork pushen

• Pushen Sie Ihren Branch zu Ihrem geforkten Repository:

  git push origin feature/your-branch-name

8. 📥 Einen Pull Request (PR) einreichen

• Gehen Sie zum ursprünglichen Carch-Repository auf GitHub.
• Klicken Sie auf New Pull Request.
• Wählen Sie Ihren Branch aus dem Dropdown-Menü und beschreiben Sie Ihre Änderungen im Detail.
• Reichen Sie den PR zur Überprüfung ein!

📚 Beitrag zur Carch-Dokumentation

Carch Docs ist ➥ Hier live

🚀 Möglichkeiten beizutragen

Sie können beitragen durch:

• 🪛 Behebung von Tippfehlern oder Fehlern in bestehenden Leitfäden
• 🌐 Übersetzung der Dokumentation in andere Sprachen (sehr erwünscht!)

🌍 Dokumentation übersetzen

Möchten Sie helfen, Carch für Benutzer weltweit zugänglich zu machen? Helfen Sie uns bei der Übersetzung der Dokumentation!

Wenn Sie eine neue Sprache beitragen, folgen Sie diesen Schritten:

1. 📁 Erstellen Sie einen neuen Ordner für Ihre Sprache im docs/-Verzeichnis. Verwenden Sie ISO 639-1-Codes (z.B. fr, es, hi, usw.).
2. 🛠️ Übersetzen Sie den Markdown-Inhalt im neuen Ordner.
3. 🧩 Ändern Sie docs/.vitepress/config.ts:
   • Fügen Sie Ihre Sprache im locales-Bereich hinzu.
   • Geben Sie ein label, lang und link für die Navigation an.

🧪 Ihre Änderungen lokal testen

Um Ihre Änderungen in der Vorschau zu sehen:

bun install
bun run docs:dev

IMPORTANT

Bitte öffnen Sie zuerst ein Issue, wenn Sie größere strukturelle oder organisatorische Änderungen einführen möchten. Wir würden gerne vorab darüber diskutieren und zusammenarbeiten!

🧾 Commit-Stil

Verwenden Sie klare Commit-Nachrichten wie:

git commit -m "fix(docs): Tippfehler in der Installationsanleitung korrigieren"
git commit -m "feat(docs): Deutsche Übersetzung hinzufügen"

Mehr über Conventional Commits.

🙌 Danke, dass Sie bei der Verbesserung der Dokumentation helfen!

Richtlinien

Code-Qualität

• Folgen Sie dem bestehenden Coding-Stil des Projekts.
• Schreiben Sie klaren, prägnanten und gut dokumentierten Code.

Testen

• Testen Sie Ihre Änderungen lokal, um sicherzustellen, dass sie wie erwartet funktionieren.
• Wenn Ihre Änderungen neue Features einführen, fügen Sie notwendige Tests hinzu, wo anwendbar.

Dokumentation

• Wenn Ihre Änderungen neue Funktionalitäten beinhalten, aktualisieren Sie die relevante Dokumentation.
• Stellen Sie sicher, dass die README oder das Wiki Ihre Updates widerspiegelt.

Ihren Fork synchronisieren

• Halten Sie Ihren Fork aktuell, um Konflikte zu vermeiden:

  git fetch upstream

  git merge upstream/main

  • Ersetzen Sie main durch den Standard-Branch des Repositories, falls er unterschiedlich ist.

Vielen Dank für Ihren Beitrag zu Carch! Ihre Bemühungen helfen dabei, dieses Projekt für alle besser zu machen.