Aller Anfang ist schwer. Gerade dann, wenn wir gemeinsam an etwas arbeiten, will niemand etwas Falsches tun. Aber Open Source dreht sich um Kooperation und lebt von den Beiträgen vieler Freiwilliger. Deshalb haben wir es uns zur Aufgabe gemacht, neuen Mitgliedern in der Open-Source-Gemeinde ihre ersten Schritte so einfach wie möglich zu machen.
Natürlich helfen die vorhandenen Artikel und Videoanleitungen. Aber was kann besser sein, als es einfach einmal auszuprobieren mit dem Wissen, dass man nichts kaputt machen kann? Dieses Projekt will Anfängern zeigen, wie sie möglichst einfach ihren ersten Beitrag leisten. Bedenke: Je entspannter du bist, desto besser lernst du. Wenn du deinen ersten Beitrag leisten möchtest, folge diesen einfachen Schritten. Wir versprechen dir, es wird Spaß machen.
Wenn du Git noch nicht installiert hast, installiere es
Forke das Repository durch das Anklicken der Schaltfläche "Fork". Dadurch erhältst du deine eigene Version des Projektes in deinem Profil.
Klone das Repository auf deinen Computer. Klicke auf die Schaltfläche "Clone or download" und anschließend auf das "copy to clipboard"-Symbol.
Öffne eine Kommandozeile und gib das folgende git-Kommando ein:
git clone "Deine kopierte URL"
Statt 'Deine kopierte URL' (ohne Anführungszeichen) füge die Repository-URL aus dem vorherigen Schritt ein.
Beispiel:
git clone https://github.com/dein-Name/first-contributions.git
An der Stelle 'dein-Name' muss dein GitHub-Username stehen. Mit diesem Befehl kopierst du den Inhalt deines first-contributions-Repository von GitHub auf deinen Computer.
Wechsle zum Repository-Verzeichnis auf deinem Computer (falls du es nicht schon getan hast).
cd first-contributions
Erstelle nun einen Branch mit dem Befehl git checkout
:
git checkout -b <add-dein-Name>
Beispiel:
git checkout -b add-max-mustermann
(Der Name des Branches muss nicht unbedingt das Wort add beinhalten aber hier ist es sinnvoll, denn der Zweck deines Branches ist es ja, deinen Namen zur Liste hinzuzufügen.)
Öffne Contributors.md
in einem Text-Editor und füge deine Namen hinzu. Beachte, dass du den Namen nicht am Anfang oder am Ende der Datei hinzufügst. Speichere die Datei anschließend.
Gibst du in der Kommandozeile nun git status
ein, siehst du die Änderungen.
Füge die Änderungen mit dem Befehl git add
zu deinem eben erstellten Branch hinzu:
git add Contributors.md
Nun committest du deine Änderungen mit git commit
:
git commit -m "Add <dein-Name> to Contributors list"
Ersetze <dein-Name>
mit deinem Namen.
Pushe die Änderungen mit git push
:
git push origin <add-dein-Name>
Ersetze <add-dein-Name>
mit dem Namen des Branches, den du zuvor erstellt hast.
Wenn du jetzt zu deinem Repository auf GitHub gehst, siehst du einen Knopf Compare & pull request
. Klicke darauf.
Erstelle einen Pull Request indem du auf die Schaltfläche Create pull request
klickst.
Roshan Jossey wird nun deine Änderungen in den Master Branch dieses Projekts mergen. Du erhältst eine E-Mail sobald dies geschehen ist.
Glückwunsch! Du hast so eben den Standard-Workflow Fork -> Clone -> Edit -> Pull Request beendet, der dir als Mitwirkender häufig begegnen wird.
Feiere deinen Beitrag zum Projekt und teile ihn mit deinen Freunden und Followern über unsere Web-App.
Wenn du weitere Fragen hast, kannst du Mitglied in unserem Slack-Team werden. Join Slack Team.
Falls du jetzt zu anderen Projekten beitragen möchtest, dann haben wir für dich eine Liste von einfachen, ersten Issues zusammengestellt, an denen du arbeiten kannst. Diese Projekt-Liste findest du in unserer Web-App.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code |
Wenn dir dieses Projekt gefällt, denn gib ihm doch einen Stern auf GitHub. Falls du dich gerade besonders wohltätig fühlst, dann folge Roshan auf Twitter und GitHub.