Skip to content

Commit

Permalink
Fix some typos and confusing grammatical constructions.
Browse files Browse the repository at this point in the history
  • Loading branch information
stefanpf committed Dec 11, 2018
1 parent 9c61e7a commit 5e0d203
Showing 1 changed file with 30 additions and 24 deletions.
54 changes: 30 additions & 24 deletions translations/README.de.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,37 +8,37 @@

<img align="right" width="300" src="../assets/fork.png" alt="Repository forken" />

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 von vielen Freiwilligen. 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.
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? Diese 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.
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 Git noch nicht installiert ist, [ installiere es ]( https://help.github.com/articles/set-up-git/ )
Wenn du Git noch nicht installiert ist, [ installiere es ]( https://help.github.com/articles/set-up-git/ )

## Repository forken

Forke das Repository durch das Anklicken der Schaltfläche "Fork". Dadurch erhältst du deine eigenen Version des Projektes in deinem Profil.
Forke das Repository durch das Anklicken der Schaltfläche "Fork". Dadurch erhältst du deine eigene Version des Projektes in deinem Profil.

## Repository klonen

<img align="right" width="300" src="../assets/clone.png" alt="Repository klonen" />

Klone das Repository auf deinen Computer. Klicke auf die Schaltfläche "Clone or download" und anschließend auf das "copy to clipboard" Symbol.
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:
Ö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.
Statt 'Deine kopierte URL' (ohne Anführungszeichen) füge die Repository-URL aus dem vorherigen Schritt ein.

<img align="right" width="300" src="../assets/copy-to-clipboard.png" alt="URL kopieren" />

Beispiel:
```
git clone https://github.com/dein-Name/first-contributions.git
```
An der Stelle 'dein-Name' muss dein Github Username stehen. Hier landet die Kopie deines first-contributions Repository von Github.
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.

## Erstelle einen Branch

Expand All @@ -47,7 +47,7 @@ Wechsle zum Repository-Verzeichnis auf deinem Computer (falls du es nicht schon
```
cd first-contributions
```
Erstelle nun einen Branch mit dem Befehl `git checkout` command.
Erstelle nun einen Branch mit dem Befehl `git checkout`:
```
git checkout -b <add-dein-Name>
```
Expand All @@ -57,40 +57,47 @@ 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.)

## Mache die nötigen Änderungen und committe sie

Öffne `Contributors.md` in einem Text-Editor, füge deinen Namen hinzu und speichere die Datei. Gibst du in der Kommandozeile nun `git status` ein, siehst du die Änderungen. Füge die Änderungen mit dem Befehl `git add` hinzu.
Ö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 mit `git commit`.
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 Änderung zu Github
## Pushe die Änderung zu GitHub

Pushe die Änderungen mit `git push`.
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.

## Sende deine Änderungen zum Review

Wenn du jetzt zu deinem Repository auf Github gehst, siehst du einen Knopf `Compare & pull request`. Klicke darauf.
Wenn du jetzt zu deinem Repository auf GitHub gehst, siehst du einen Knopf `Compare & pull request`. Klicke darauf.

<img style="float: right;" src="../assets/compare-and-pull.png" alt="Erstelle einen pull request" />

Erstelle einen Pull Request.
Erstelle einen Pull Request indem du auf die Schaltfläche `Create pull request` klickst.

<img style="float: right;" src="../assets/submit-pull-request.png" alt="Pull Request senden" />

Roshanjossey wird nun deine Änderungen in den Master Branch dieses Projekts mergen. Du erhältst eine E-Mail sobald dies geschehen ist.

## Einen Branch aus deinem Repository löschen

Wenn du der Anleitung bis hierher gefolgt bist und dein Pull Request angenommen wurde, hat dein Branch `<add-dein-Name>` seinen Zweck erfüllt und wird nicht länger benötigt. Du kannst ihn in deiner lokalen Arbeitskopie löschen. Dies ist zwar nicht zwingend notwendig, hilft dir aber dabei den Überblick zu bewahren.

Lass uns dazu zuerst den Branch `<add-dein-Name>` aus deiner lokalen Arbeitskopie in deinen master Branch mergen. Dazu wechseln wir zuerst in den master:
Expand All @@ -117,12 +124,11 @@ git push origin --delete <add-dein-Name>

Nun weißt du, wie man Branches am Ende ihrer Lebenszeit löscht.

So wie du einen Pull Request gestellt hast, werden hoffentlich viele andere Entwickler einen Beitrag zum Projekt leisten. Sobald ein Pull Request angenommen wurde, sind die Änderungen im Master Branch des Projektes. In deinen Fork werden die Änderungen von anderen Freiwilligen aber nicht automatisch übernommen. Damit du immer die neuste Version hast, musst du regelmäßig synchronisieren. Wie dies geschieht wird im folgenden Kapitel erklärt.
So wie du einen Pull Request gestellt hast, werden hoffentlich viele andere Entwickler einen Beitrag zum Projekt leisten. Sobald ein Pull Request angenommen wurde, sind die Änderungen im Master Branch des Projektes. In deinen Fork werden die Änderungen von anderen Freiwilligen aber nicht automatisch übernommen. Damit du immer die neueste Version hast, musst du regelmäßig synchronisieren. Wie dies geschieht wird im folgenden Kapitel erklärt.

## Halte deinen Fork synchron

Für die weiter Anleitung ist es wichtig den Ablauf einer vollen Synchronisation zu verstehen. In unserem Beispiel gibt es drei verschiedene Repositories: Das öffentliche Repository von Roshanjossey.
`github.com/Roshanjossey/first-contributions/`, dein öffentlicher Fork auf GitHub `github.com/dein-Name/first-contributions/` und die lokale Arbeitskopie auf deinem PC. Damit deine beiden Versionen synchron bleiben, müssen wir zuerst die Änderungen des öffentlichen Projektes von Roshanjossey holen (`fetch`) und mit deiner lokalen Arbeitskopie mergen. Im zweiten Schritt werden wir dann die Änderungen von deiner lokalen Arbeitskopie zu deinem öffentlichen GitHub Projekt pushen. Das ist wichtig, weil du nur für die Versionen auf deinem öffentlichen GitHub Projekt Pull Request stellen kannst.
Für die weiter Anleitung ist es wichtig den Ablauf einer vollen Synchronisation zu verstehen. In unserem Beispiel gibt es drei verschiedene Repositories: Das öffentliche Repository von Roshanjossey, `github.com/Roshanjossey/first-contributions/`, dein öffentlicher Fork auf GitHub `github.com/dein-Name/first-contributions/` und die lokale Arbeitskopie auf deinem PC. Damit deine beiden Versionen synchron bleiben, müssen wir zuerst die Änderungen des öffentlichen Projektes von Roshanjossey holen (`fetch`) und mit deiner lokalen Arbeitskopie mergen. Im zweiten Schritt werden wir dann die Änderungen von deiner lokalen Arbeitskopie zu deinem öffentlichen GitHub-Projekt pushen. Das ist wichtig, weil du nur für die Versionen auf deinem öffentlichen GitHub-Projekt Pull Requests stellen kannst.

Hier die Schritte für eine vollständige Synchronisation:

Expand All @@ -135,25 +141,25 @@ Wenn du nicht im Master bist, dann wechsle mit folgendem Befehl:
git checkout master
```

Füge Roshanjossey Repository URL mit `upstream remote url` hinzu.
Füge Roshanjosseys Repository-URL mit `upstream remote url` hinzu:

```
git remote add upstream https://github.com/Roshanjossey/first-contributions
```
Auf diese Weise sagst du Git, dass es noch eine andere Version dieses Projekts gibt, die wir upstream nennen. Lade nur die neueste Version dieses Repositories.
Auf diese Weise sagst du Git, dass es noch eine andere Version dieses Projekts gibt, die wir upstream nennen. Lade nun die neueste Version dieses Repositories:
```
git fetch upstream
```

Hier laden wir alle Änderungen von Roshanjosseys Forks herunter (upstream). Danach müssen wir dessen Änderungen in den Master deiner lokalen Arbeitskopie mergen.
Hier laden wir alle Änderungen von Roshanjosseys Forks herunter (upstream). Danach müssen wir dessen Änderungen in den Master deiner lokalen Arbeitskopie mergen:
```
git rebase upstream/master
```
So wendest du alle Änderungen, die du heruntergeladen hast, im Master Branch an. Deine lokale Kopie hat nun den gleichen Stand, wie das öffentliche Repository. Wenn du den Master Branch jetzt pushst, ist auch dein Fork auf GitHub wieder aktuell.
So wendest du alle Änderungen, die du heruntergeladen hast, im Master Branch an. Deine lokale Kopie hat nun den gleichen Stand wie das öffentliche Repository. Wenn du den Master Branch jetzt pushst, ist auch dein Fork auf GitHub wieder aktuell.
```
git push origin master
```
Beachte, dass du hier zum Remote Namens origin pushst. Origin ist ein besonderer Name, er steht für das Projekt aus dem du initial mit git checkout geclont hast. Es ist also deine Kopie des Projektes auf GitHub.
Beachte, dass du hier zum Remote-Namen origin pushst. Origin ist ein besonderer Name, er steht für das Projekt aus dem du initial mit `git checkout` geclont hast. Es ist also deine Kopie des Projektes auf GitHub.

## Tutorials mit anderen Tools

Expand All @@ -166,7 +172,7 @@ Beachte, dass du hier zum Remote Namens origin pushst. Origin ist ein besonderer

Wenn du weitere Fragen hast kannst du Mitglied in unserem Slackteam werden. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY).

Hier sind einige Anfänger-Level Aufgaben (issues) in bekannten Repositories die du lösen kannst. Schau sie dir an und erfahre mehr darüber
Hier sind einige Anfänger-Level-Aufgaben (issues) in bekannten Repositories, die du lösen kannst. Schau sie dir an und erfahre mehr darüber

|[![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[<img width="100" src="https://cdn.worldvectorlogo.com/logos/react.svg">](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[<img width="100" src="https://camo.githubusercontent.com/0f302c808c8457f6460913e33aed3478124612c2/687474703a2f2f6c65696e696e67656e2e6f72672f696d672f6c65696e696e67656e2e6a7067">](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[<img width="100" src="https://images.plot.ly/plotly-documentation/thumbnail/numpy-logo.jpg">](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)|
|---|---|---|---|---|---|---|---|
Expand Down

0 comments on commit 5e0d203

Please sign in to comment.