First Contributions

Dieses Projekt zielt darauf ab, Anfängern den Einstieg zu erleichtern und sie bei ihrem ersten Beitrag zu unterstützen. Wenn du deinen ersten Beitrag leisten möchten, befolge die folgenden Schritte.

Wenn du nicht weißt wie man das Terminal/CMD bedient, hier findest du Anleitungen für GUI Tools.

Wenn du Git nicht auf deinem System installiert hast, installiere es.

Forke dieses Repository

Forke dieses Repository indem du auf den Fork Button oben auf dieser Seite klickst. Dies wird eine Kopie dieses Repository's in deinem Account erstellen.

Klone das Repository

Klone jetzt das geforkte Repository auf deinen Computer. Gehe zu deinem Github Account, öffne das geforkte Repository, drücke auf den Code Button, dann auf den SSH Tab und dann drücke auf das copy url to clipboard icon.

Öffne ein Terminal Fenster und führe den folgenden Git Befehl aus:

git clone "kopierte url"

wobei "kopierte url" (ohne die Anführungszeichen) die url zu diesem Repository ist (deine Fork von diesem Projekt). Im vorherigen Schritt siehst du wie du diese erhälst .

Zum Beispiel:

git clone git@github.com:das-bist-du/erster-Beitrag.git

wobei das-bist-du dein Github Nutzername ist. Hier kopierst du den Inhalt des first-contributions Repository's auf Github auf deinen Computer.

Erstelle einen Zweig

Wechsle zum Repository Ordner (wenn du nicht bereits dort bist):

cd first-contributions

Erstelle nun einen Zweig, indem du den git switch Befehl benutzst:

git switch -c dein-neuer-zweig-name

Zum Beispiel:

git switch -c add-alonzo-church

Wenn du auf irgendeinen Fehler bei der Nutzung von git switch stößt, drücke hier:

Wenn die Fehlermeldung "Git: switch is not a git command. See git –help" erscheint, liegt dies wahrscheinlich daran das du eine veraltete Version von Git nutzt.

In diesem Fall versuche stattdessen git checkout zu nutzen:

git checkout -b dein-neuer-zweig-name

Make necessary changes and commit those changes

Öffne nun die Datei Contributors.md in einem Texteditor und füge deinen Namen hinzu. Füge ihn nicht ganz am Anfang oder am Ende hinzu, sondern irgendwo dazwischen, mittendrin. Speichere jetzt die Datei.

Wenn du in den Projektordner gehst und den Befehl git status, ausführst werden dir die Änderungen angezeigt.

Füge diese Änderungen nun zu dem Zweig hinzu den du gerade erstellt hast, indem du den Befehl git add ausführst.

git add Contributors.md

Jetzt commite diese Änderungen mit dem git commit Befehl:

git commit -m "Add your-name to Contributors list"

ersetze your-name mit deinem Namen.

Änderungen auf Github pushen

Übertrage deine Änderungen mit git push:

git push -u origin dein-zweig-name

ersetze dein-zweig-name mit dem Namen des Zweiges den du vorhin erstellt hast.

Solltest du auf irgendwelche Fehler beim Pushen stoßen, drücke hier:

Authentifizierungs Fehler

remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
fatal: Authentication failed for 'https://github.com//first-contributions.git/'

Gehe zu GitHub's tutorial wie du einen ssh Key zu deinem Account hinzufügst und konfigurierst. Außerdem, kannst du 'git remote -v' ausführen um deine Remote Addresse anzuzeigen.

Wenn es so aussieht:

origin	https://github.com/your-username/your_repo.git (fetch)
origin	https://github.com/your-username/your_repo.git (push)

ändere es mit diesem Befehl:

git remote set-url origin git@github.com:dein-nutzername/dein_repo.git

Ansonsten wirst du noch immer aufgefordert Passwort und Benutzername einzugeben und bekommst einen Authentifizierungs Fehler.

Reiche deine Änderungen für ein Review ein

Wenn du jetzt zu deinem Repository auf Github gehts, wirst du einen Compare & pull request Knopf sehen. Drücke diesen Knopf.

Jetzt, reiche deine Pull-Request ein.

Bald werde ich alle deine Änderungen in den Haupt-Zweig dieses Projektes mergen. Du wirst eine Benachrichtigungs Email bekommen sobald die Änderungen gemerged wurden.

Was nun?

Gratulation! Du hast gerade den Standard Forken -> Klonen -> Bearbeiten -> Pull-Request Workflow durchgeführt, dem du als Beitragender oft begegnen wirst!

Feier deinen Beitrag und teile in mit deinen Freunden und Followern indem du hier drückst web app.

Wenn du gerne mehr Übung hättest, schau dir code contributions an.

Jetzt los gehts, mit Beiträgen zu anderen Projekten. Wir haben eine Liste von Projekten mit leichten Fehlern für Einsteiger bereitgestellt. Schau dir die Liste der Projekte in der Web-App an an.