Skip to content

Latest commit

 

History

History
62 lines (44 loc) · 6.05 KB

CONTRIBUTING_de-DE.md

File metadata and controls

62 lines (44 loc) · 6.05 KB
Raw

Willkommen!

Sie sind hier, um jmbde-macos zu helfen? Wunderbar, fühlen Sie sich frei und lesen Sie die folgenden Abschnitte, um zu wissen, wie man an etwas arbeitet und woher man Hilfe bekommen kann. Ihr Beitrag ist sehr wichtig, jmbde-macos wird durch Menschen wie Sie immer besser und besser. 😄

Welche Art von Beiträgen suchen wir?

  • Wenn Ihnen jmbde-macos gefällt, starten Sie dieses Projekt und teilen Sie es mit Ihren Freunden.
  • Melden Sie Fehler oder fordern Sie neue Funktionen an unter opening issues. Bitte folgen Sie den Problemvorlagen und stellen Sie detaillierte Informationen zur Verfügung, dies wird den Entwicklern helfen, den Grund des Fehlers zu finden und zu verstehen, welche Funktion Sie genau anfordern.
  • Helfen Sie anderen Personen bei Problemen/Anfragen in anderen Plattformen, wenn Sie in der Lage sind, ihnen zu helfen.
  • Schreiben Sie Tutorials und Blogs über die Verwendung von jmbde-macos.
  • Verbessern Sie die Dokumentation, einschließlich der Markdown-Dateien und der Kommentare in den Codes.
  • Schreiben Sie Codes für neue Funktionen oder Fehlerbehebungen.

Ihr erster Beitrag

Arbeiten Sie an Ihrer ersten Pull-Anfrage? Sie können von dieser freien Serie Wie man zu einem Open-Source-Projekt auf GitHub beiträgt lernen. Im Grunde genommen müssen Sie dieses Repository abspalten, Codes auf Ihre Abspaltung schreiben, eine Pull-Anfrage öffnen, wenn Sie fertig sind, auf Überprüfungen warten und Vorschläge von den Betreuern einbringen.

Fangen Sie an Software zu entwickeln? Es gibt einen großen Unterschied zwischen Entwickeln und ambitionierter Programmierung, aber das ist nicht schwer. In einer Suchmaschine nachzuschauen ist für das, was Sie implementieren wollen, ist normalerweise hilfreich. Kopieren und modifizieren Sie den Quellcode, wenn Sie etwas Ähnliches wie eine bestehende Funktion implementieren wollen. Wenn Sie nach einer IDE zum Entwickeln suchen, ist VS Code wahrscheinlich eine gute Wahl.

Erstes Mal zu swift? Keine Angst, swift ist nicht schwer zu beginnen. Sie müssen zuerst Xcode installieren.

Wissen Sie nicht, wo Sie anfangen sollen? Sie können damit anfangen, die issues durchzusehen und ein Thema zu finden, das Sie interessiert. Die guten Erstausgaben könnte für Sie geeignet sein.

Vor dem Schreiben von Codes

Bitte öffnen Sie ein Problem (beschreiben Sie das Merkmal/den Fehler wie normale Probleme und sagen Sie, dass Sie daran arbeiten werden, wahrscheinlich mit einem Entwurf, wie Sie es implementieren möchten), bevor Sie Codes für eine Pull-Anfrage schreiben, aus diesen Gründen:

  1. Sie können Hilfe von anderen erhalten.
  2. Andere können wissen, dass Sie daran arbeiten, dies erspart Ihnen mögliche Doppelarbeiten.
  3. Sie werden benachrichtigt, wenn diese Funktion nicht akzeptiert wird, oder wenn der "Fehler" tatsächlich kein Fehler ist usw., was Ihnen Zeit spart.

Regeln für Beiträge

  • Denken Sie daran, dass es das Ziel ist, ein jmbde-macos für Benutzer, nicht für Entwickler zu erstellen.
  • Tun Sie eine Sache bei einer Pull-Anfrage. Wenn Sie mehrere Funktionen hinzufügen/mehrere Fehler beheben wollen und diese nicht relevant sind, öffnen Sie mehrere Pull-Requests. Möglicherweise müssen Sie mehrere Zweige erstellen, um mehrere Pull-Anfragen zu öffnen, Sie können das Verzweigen von Git [hier] lernen (https://learngitbranching.js.org/).
  • Fügen Sie neue Funktionen auf dem Master-Zweig hinzu und beheben Sie den Fehler auf dem letzten aktiven Zweig (Master-, Beta- und Stable-Zweig), in dem der Fehler aufgetreten ist.
  • Bitte schreiben Sie clear commit messages. Es wird auch empfohlen, Konventionelle Commits zu schreiben. Sie können commitizen/cz-cli verwenden, um Commit-Nachrichten zu schreiben. Die Regeln sind jedoch optional, der Schlüssel ist, dass andere und Sie selbst in Zukunft verstehen sollten, was geändert wurde und warum diese Änderungen vorgenommen wurden.
  • Benutzen Sie Clang-Format 9 (benutzen Sie clang-format --version, um Ihre Version zu überprüfen, Sie müssen möglicherweise den Binärpfad für Ihre IDE im Clang-Format einstellen, z.B. kann die Standardversion von clang-format im VS-Code clang-format-6 sein) und .clang-format im Wurzelverzeichnis, um Ihre Codes zu formatieren.
  • Entfernen Sie keine Features, es sei denn, es ist notwendig. Fügen Sie stattdessen eine Option zur Deaktivierung einer Funktion hinzu.
  • Halten Sie die Einstellungsdatei die ganze Zeit abwärtskompatibel.
  • Windows, Linux und Mac OS sollten unterstützt werden.
  • Beide hell/dunkel Systemthemen sollten unterstützt werden.
  • Jeder sollte sich an den Verhaltenskodex halten, um eine belästigungsfreie Gemeinschaft aufzubauen.

FAQ

  • Kann ich es gut machen, wenn ich gerade erst angefangen habe?

    • Jeder weiß am Anfang nichts. Machen Sie sich keine Sorgen, unsere coolen Mitwirkenden helfen Ihnen, wenn Sie auf Schwierigkeiten stoßen. Wenn Sie :Herz: Open Source und weiter versuchen, wird alles besser und besser werden.

  • Muss ich etwas über CMake lernen?

  • Einige Dateien fehlen beim Kompilieren.

    • Wenn die CI-Tests bestanden werden, liegt das wahrscheinlich daran, dass die Untermodule aktualisiert werden. Sie können die folgenden Befehle ausführen:

      git add .
git reset --hard
git submodule update --init
```

Sie können auch `git rm` alle Submodule versuchen und sie dann erneut initialisieren oder sogar das Repo auf Ihrer Platte löschen und erneut klonen.