Merge pull request #142 from max123kl/English_Commits

included from English Repo until 10 Aug

Author: max123kl

CONTRIBUTING.asc

@@ -1,39 +1,43 @@
 = Zur Übersetzung der zweiten Auflage von Git Pro beitragen
 
-== Lizenz
+== Ihre Arbeit an uns lizenzieren
 
-Mit Erzeugen eines Pull-Requests für dieses Repository stimmen Sie zu, dass Ihre Arbeit unter die angegebene link:LICENSE.asc[Projektlizenz] gestellt wird.
+Wenn Sie einen Pull-Request öffnen, erklären Sie sich damit einverstanden, dass Ihre Arbeit unter der link:LICENSE.asc[Projektlizenz] veröffentlicht wird.
 Außerdem erklären Sie sich damit einverstanden, eine solche Lizenz an Ihrer Arbeit den Hauptautoren @ben und @schacon zu gewähren, die sie für zukünftige, gedruckte Ausgaben benötigen.
 Sollten Ihre Änderungen in einer gedruckten Fassung erscheinen, so werden Sie in die Liste der link:book/contributors.asc[Mitwirkenden] aufgenommen.
 
-== Ein Problem melden
+== Ein Problem (Issue) melden
 
-Bevor Sie ein Problem melden, bitten wir Sie zu überprüfen, ob sich nicht ein ähnliches oder gar dasselbe Problem bereits im Bugtracking-System befindet.
+Suchen Sie nach ähnlichen Issues, bevor Sie ein neues erstellen.
 
-Wenn das Problem auch auf der link:https://git-scm.com[Git-Website] zu finden ist, überprüfen Sie bitte auch, ob das Problem dort noch aktuell ist. Es könnte schon erledigt, aber noch nicht veröffentlicht sein.
+Wenn Sie das Problem auch auf der link:https://git-scm.com[Git-Website] entdeckt haben, überprüfen Sie bitte, ob das Problem auch in der PDF-Version vorhanden ist.
+Möglicherweise wurde das Problem bereits in den Quelldateien korrigiert, aber noch nicht auf der link:https://git-scm.com[Git-Website] veröffentlicht.
 
 == Kleinere Korrekturen
 
 Fehlerkorrekturen und grundlegende Klarstellungen werden akzeptiert, wenn wir uns einig sind, dass sie den Inhalt verbessern.
-Sie können auch ein Issue eröffnen, damit wir herausfinden können, wie oder ob es gelöst werden muss.
+Sie können auch ein Issue öffnen, so dass wir diskutieren können, wie oder ob das Issue gelöst werden muss.
 
 Wenn Sie dies noch nie zuvor getan haben, kann der link:https://guides.github.com/introduction/flow/[Flow Guide] hilfreich sein.
 
 == Größere Änderungen
 
 Öffnen Sie ein Issue zur Diskussion, bevor Sie beginnen.
-Diese Veränderungen sind in der Regel sehr subjektiv, oft nur klärende Dinge für einen kleinen Prozentsatz der Menschen und es lohnt sich selten, sie zu akzeptieren.
-Professionelle Textredakteure haben diesen Inhalt bereits mehrmals überprüft, so dass es unwahrscheinlich ist, dass Ihre Texte so viel besser werden, dass es sich lohnt, große Textmengen zu ändern, obwohl Sie vielleicht einen etwas besseren Geschmack und bessere Grammatik haben als wir.
+Eine umfangreiche Korrektur neigt dazu, sehr subjektiv zu sein und die Dinge oft nur für eine kleinere Anzahl von Lesern zu verbessern.
+Professionelle Textredakteure haben diesen Inhalt bereits mehrfach überprüft.
+Es ist unwahrscheinlich, dass Ihre neue Textfassung *so* viel besser wird, dass es sich lohnt, große Teile des Inhalts zu ändern.
 
 == Abbildungen
 
 Die Bilder in diesem Buch wurden mit link:https://www.sketchapp.com/[Sketch 3] und der link:https://github.com/progit/progit2/blob/master/diagram-source/progit.sketch[mitgelieferten Sketchbook-Datei] erstellt.
 
-Um eine Abbildung einzufügen:
+Um eine Abbildung zu erstellen:
 
-1. Fügen Sie eine Seite zum Sketchbook hinzu. Versuchen Sie möglichst die enthaltenen Symbole zu verwenden.
-2. Fügen Sie Ihrer Seite ein „Slice“ hinzu. Geben Sie ihm einen Namen, der mit dem PNG-Dateinamen des Ziels übereinstimmt, relativ zur Root des Quellverzeichnisses.
-3. Vergewissern Sie sich, dass Ihr Slice so eingestellt ist, dass er mit „800w“ exportiert wird.
+1. Fügen Sie eine Seite zum Sketchbook hinzu.
+Verwenden Sie, wo immer möglich, die mitgelieferten Symbole.
+2. Fügen Sie Ihrer Seite einen „Slice“ hinzu.
+Geben Sie ihm einen Namen, der mit dem PNG-Dateinamen des Ziels übereinstimmt, relativ zur Root des Quellverzeichnisses.
+3. Stellen Sie den Export Ihres Slice auf „800w“ ein.
 
 == Übersetzungen
 

CONTRIBUTING.md

@@ -2,43 +2,44 @@
 
 ## Licensing
 
-By opening a pull request to this repository, you agree to provide your work under the [project license](LICENSE.asc).
+When you open a pull request, you agree to provide your work under the [project license](LICENSE.asc).
 Also, you agree to grant such license of your work as is required for the purposes of future print editions to @ben and @schacon.
 Should your changes appear in a printed edition, you'll be included in the [contributors list](book/contributors.asc).
 
 ## Signaling an Issue
 
-Before signaling an issue, please check that there isn't already a similar one in the bug tracking system.
+Search for similar issues, before creating a new issue.
 
-Also, if this issue has been spotted on the git-scm.com site, please cross-check that it is still present in the pdf version.
-The issue may have already been corrected, but the changes have not been deployed yet.
+Also, if this issue has been spotted on the git-scm.com site, cross-check that the issue is present in the pdf version.
+The issue may have already been corrected in the source files, but not yet deployed to the git-scm.com site.
 
 ## Small Corrections
 
 Errata and basic clarifications will be accepted if we agree that they improve the content.
-You can also open an issue so we can figure out how or if it needs to be addressed.
+You can also open an issue so that we can discuss how or if the issue needs to be addressed.
 
 If you've never done this before, the [flow guide](https://guides.github.com/introduction/flow/) might be useful.
 
 ## Large Rewrites
 
 Open an issue for discussion before you start.
-These changes tend to be very subjective, often only clarifying things for some small percentage of people and it's rarely worth the time to accept them.
-Professional copy editors have already reviewed this content multiple times so while you may have somewhat better taste and grammar than we do it's unlikely that your prose is going to be *so* much better that it's worth changing vast swaths of text.
+A large rewrite tends to be very subjective, often only clarifying things for a small amount of readers.
+Professional copy editors have already reviewed this content multiple times.
+It's unlikely that your prose is going to be *so* much better that it's worth changing large portions of text.
 
 ## Figures
 
-The images in this book were generated using [Sketch 3](https://www.sketchapp.com/), with the [included sketchbook file](diagram-source/progit.sketch).
+The images in this book are generated using [Sketch 3](https://www.sketchapp.com/), with the [included sketchbook file](diagram-source/progit.sketch).
 
-To add a figure:
+To create a figure:
 
 1. Add a page to the sketchbook.
-Try to use the included symbols wherever possible.
+Use the included symbols wherever possible.
 2. Add a "slice" to your page.
-Give it a name that matches the destination PNG filename, relative from the root of the source directory.
-3. Make sure your slice is set to export at "800w".
+Name the slice so that it matches the destination PNG filename, relative from the root of the source directory.
+3. Set your slice to export at "800w".
 
 
 ## Translations
 
-If you would like to contribute to translating Pro Git into your language, take a look at [TRANSLATING.md](TRANSLATING.md).
+If you want to contribute to translating Pro Git into your language, take a look at [TRANSLATING.md](TRANSLATING.md).

TRANSLATING.md

@@ -57,7 +57,7 @@ Wenn es noch kein Projekt für Ihre Sprache gibt, können Sie eine eigene Übers
 
 Grundlage Ihrer Arbeit ist die zweite Ausgabe des Buches, die [hier](https://github.com/progit/progit2) verfügbar ist. So sollten Sie vorgehen:
  1. Wählen Sie den richtigen [ISO 639-Code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) für Ihre Sprache.
- 1. Erstellen Sie eine [GitHub-Organisation](https://help.github.com/articles/creating-a-new-organization-from-scratch/), z.B. `progit2-[your code]` auf GitHub.
+ 1. Erstellen Sie eine [GitHub-Organisation](https://docs.github.com/en/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch), z.B. `progit2-[Ihr_Code]` auf GitHub.
  1. Erstellen Sie ein Projekt ``progit2``.
  1. Kopieren Sie die Struktur von progit/progit2 (dieses Projekt) in Ihr Projekt und beginnen Sie mit der Übersetzung.
 

book/01-introduction/sections/first-time-setup.asc

@@ -8,7 +8,7 @@ Die Git-Konfiguration kann auch jederzeit geändert werden, indem die nachfolgen
 Git umfasst das Werkzeug `git config`, welches die Möglichkeit bietet, Konfigurationswerte zu verändern. Auf diese Weise können Sie anpassen, wie Git aussieht und arbeitet.(((Git Befehle, config)))
 Die Konfiguration ist an drei verschiedenen Orten gespeichert:
 
-1. Die Datei `/etc/gitconfig`: enthält Werte, die für jeden Benutzer auf dem System und alle seine Repositorys gelten.
+1. Die Datei `[path]/etc/gitconfig`: enthält Werte, die für jeden Benutzer auf dem System und alle seine Repositorys gelten.
   Wenn Sie die Option `--system` an `git config` übergeben, liest und schreibt sie spezifisch aus dieser Datei.
   Da es sich um eine Systemkonfigurationsdatei handelt, benötigen Sie Administrator- oder Superuser-Rechte, um Änderungen daran vorzunehmen.
 2. Die Datei `~/.gitconfig` oder `~/.config/git/config`: enthält Werte, die für Sie, den Benutzer, persönlich bestimmt sind.
@@ -17,10 +17,10 @@ Die Konfiguration ist an drei verschiedenen Orten gespeichert:
   Sie können Git mit der Option `--local` zwingen, aus dieser Datei zu lesen und in sie zu schreiben, das ist in der Regel die Standardoption.
   (Es dürfte Sie nicht überraschen, dass Sie sich irgendwo in einem Git-Repository befinden müssen, damit diese Option ordnungsgemäß funktioniert.)
 
-  Jede Ebene überschreibt Werte der vorherigen Ebene, so dass Werte in `.git/config` diejenigen in `/etc/gitconfig` aushebeln.
+  Jede Ebene überschreibt Werte der vorherigen Ebene, so dass Werte in `.git/config` diejenigen in `[path]/etc/gitconfig` aushebeln.
 
 Auf Windows-Systemen sucht Git nach der Datei `.gitconfig` im `$HOME` Verzeichnis (normalerweise zeigt `$HOME` bei den meisten Systemen auf `C:\Users\$USER`).
-Git schaut immer nach `/etc/gitconfig`, auch wenn die sich relativ zu dem MSys-Wurzelverzeichnis befindet, dem Verzeichnis in das Sie Git installiert haben.
+Git schaut immer nach `[path]/etc/gitconfig`, auch wenn die sich relativ zu dem MSys-Wurzelverzeichnis befindet, dem Verzeichnis in das Sie Git installiert haben.
 Wenn Sie eine Version 2.x oder neuer von Git für Windows verwenden, gibt es auch eine Konfigurationsdatei auf Systemebene unter
 `C:\Dokumente und Einstellungen\Alle Benutzer\Anwendungsdaten\Git\config` unter Windows XP und unter `C:\ProgramData\Git\config` unter Windows Vista und neuer.
 Diese Konfigurationsdatei kann nur von `git config -f <file>` als Admin geändert werden.
@@ -76,7 +76,6 @@ $ git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -m
 ====
 Vim, Emacs und Notepad++ sind beliebte Texteditoren, die von Entwicklern häufig auf Unix-basierten Systemen wie Linux und macOS oder einem Windows-System verwendet werden.
 Wenn Sie einen anderen Editor oder eine 32-Bit-Version verwenden, finden Sie in <<C-git-commands#_core_editor>> spezielle Anweisungen, wie Sie Ihren bevorzugten Editor mit Git einrichten können.
-
 ====
 
 [WARNING]
@@ -85,6 +84,18 @@ Wenn Sie Git nicht so konfigurieren, dass es Ihren Texteditor verwendet und Sie
 Ein Beispiel: auf einem Windows-System kann es eine vorzeitig beendete Git-Operation während einer von Git angestoßenen Verarbeitung sein.
 ====
 
+==== Der standardmäßige Branch-Name
+
+In der Voreinstellung wird Git einen Branch mit dem Namen _master_ erzeugen, wenn Sie ein neues Repository mit `git init` erstellen.
+Ab der Git-Version 2.28 können Sie einen abweichenden Namen für den initialen Branch festlegen.
+
+So konfigurieren Sie _main_ als Vorgabe für den Branch-Namen:
+
+[source,console]
+----
+$ git config --global init.defaultBranch main
+----
+
 ==== Einstellungen überprüfen
 
 Wenn Sie Ihre Konfigurationseinstellungen überprüfen möchten, können Sie mit dem Befehl `git config --list` alle Einstellungen auflisten, die Git derzeit finden kann:
@@ -101,7 +112,7 @@ color.diff=auto
 ...
 ----
 
-Manche Parameter werden möglicherweise mehrfach aufgelistet, weil Git denselben Parameter in verschiedenen Dateien (z.B. `/etc/gitconfig` und `~/.gitconfig`) gefunden hat.
+Manche Parameter werden möglicherweise mehrfach aufgelistet, weil Git denselben Parameter in verschiedenen Dateien (z.B. `[path]/etc/gitconfig` und `~/.gitconfig`) gefunden hat.
 In diesem Fall verwendet Git dann den jeweils zuletzt aufgelisteten Wert.
 
 Außerdem können Sie mit dem Befehl `git config <key>` prüfen, welchen Wert Git für einen bestimmten Parameter verwendet:(((Git Befehle, config)))

book/02-git-basics/sections/remotes.asc

@@ -127,6 +127,18 @@ Wenn Ihr aktueller Branch so eingerichtet ist, dass er einen entfernten Branch v
 Das könnte ein einfacherer oder komfortablerer Workflow für Sie sein. Standardmäßig richtet der Befehl `git clone` Ihren lokalen `master` Branch automatisch so ein, dass er den entfernten `master` Branch (oder wie auch immer der Standard-Branch genannt wird) auf dem Server versioniert, von dem Sie geklont haben.
 Wenn Sie `git pull` ausführen, werden normalerweise Daten von dem Server abgerufen, von dem Sie ursprünglich geklont haben, und es wird automatisch versucht, sie in den Code zu mergen, an dem Sie gerade arbeiten.
 
+[NOTE]
+====
+Ab der Version 2.27 von Git wird `git pull` eine Warnung ausgeben, wenn die Variable `pull.rebase` nicht gesetzt ist.
+Git wird Sie so lange warnen, bis Sie die Variable setzen.
+
+Falls Sie das Standardverhalten (möglichst ein fast-forward, ansonsten einen Merge-Commit erstellen) von Git beibehalten wollen:
+`git config --global pull.rebase "false"`
+
+Wenn Sie mit dem Pullen einen Rebase machen wollen:
+`git config --global pull.rebase "true"`
+====
+
 [[_pushing_remotes]]
 ==== Zu Ihren Remotes Pushen
 

book/03-git-branching/sections/rebasing.asc

@@ -235,4 +235,4 @@ Nun zur Frage, ob das Mergen oder Rebasen besser ist: hoffentlich werden Sie bem
 Git ist ein mächtiges Werkzeug und ermöglicht es Ihnen, viele Dinge mit und an Ihrem eigenen Verlauf vorzunehmen, aber jedes Team und jedes Projekt ist anders.
 Jetzt, da Sie wissen, wie diese beiden Möglichkeiten funktionieren, liegt es an Ihnen, zu entscheiden, welche für Ihre spezielle Situation die Beste ist.
 
-Für gewöhnlich lassen sich die Vorteile von beiden Techniken nutzen, indem Sie lokale Änderungen, die Sie gemacht, aber noch nicht veröffentlicht haben, mittels Rebase hinzufügen, um den Verlauf zu bereinigen, aber niemals ein Rebase an Commits durchführen, die Sie bereits irgendwohin hochgeladen haben.
+Für gewöhnlich lassen sich die Vorteile von beiden Techniken nutzen: Nehmen Sie lokale Änderungen zurück, bevor Sie Ihren Verlauf bereinigen, aber nehmen Sie niemals etwas zurück, das Sie irgendwohin gepusht haben.

book/04-git-server/sections/generating-ssh-key.asc

@@ -54,4 +54,4 @@ mZ+AW4OZPnTPI89ZPmVMLuayrD2cE86Z/il8b+gw3r3+1nKatmIkjn2so1d01QraTlMqVSsbx
 NrRFi9wrf+M7Q== [email protected]
 ----
 
-Ein ausführliches Tutorial zur Erstellung eines SSH-Schlüssels für unterschiedliche Betriebssysteme finden Sie in der GitHub-Anleitung für SSH-Schlüssel unter https://help.github.com/articles/generating-ssh-keys[Generieren eines SSH-Schlüssels].
+Ein ausführliches Tutorial zur Erstellung eines SSH-Schlüssels für unterschiedliche Betriebssysteme finden Sie in der GitHub-Anleitung für SSH-Schlüssel unter https://docs.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent[Generieren und Hinzufügen eines SSH-Schlüssels].

book/05-distributed-git/sections/maintaining.asc

@@ -343,7 +343,7 @@ Wenn die Codebasis auf diesem Branch stabil ist und die Tests erfolgreich sind,
 ===== Workflows mit umfangreichen Merges
 
 (((Workflows, "mergen (große)")))
-Das Git-Projekt selber hat vier kontinuierlich laufende Branches: `master`, `next` und `pu` (vorgeschlagene Updates) für neue Arbeiten und `maint` für Wartungs-Backports.
+Das Git-Projekt selber hat vier kontinuierlich laufende Branches: `master`, `next` und `seen` (vormals 'pu' – vorgeschlagene Updates) für neue Arbeiten und `maint` für Wartungs-Backports.
 Wenn neue Arbeiten von Mitwirkenden eingereicht werden, werden sie in ähnlicher Weise wie oben beschrieben in Themenbranches im Projektrepository des Betreuers gesammelt (siehe <<merwf_f>>).
 Zu diesem Zeitpunkt werden die Themen evaluiert, um festzustellen, ob sie korrekt sind und zur Weiterverarbeitung bereit sind oder ob sie Nacharbeit benötigen.
 Wenn sie korrekt sind, werden sie zu `next` zusammengeführt, und dieser Branch wird dann gepushed, damit jeder die miteinander integrierten Themen testen kann.
@@ -352,7 +352,7 @@ Wenn sie korrekt sind, werden sie zu `next` zusammengeführt, und dieser Branch
 .Verwaltung einer komplexen Reihe paralleler Themenbranches.
 image::images/large-merges-1.png[Verwaltung einer komplexen Reihe paralleler Themenbranches.]
 
-Wenn die Themen noch bearbeitet werden müssen, werden sie in `pu` gemergt.
+Wenn die Themen noch bearbeitet werden müssen, werden sie in `seen` gemergt.
 Wenn festgestellt wird, dass sie absolut stabil sind, werden die Themen wieder zu `master` zusammengeführt.
 Die Branches `next` und `pu` werden dann von `master` neu aufgebaut.
 Dies bedeutet, dass `master` fast immer vorwärts geht, `next` wird gelegentlich und `pu` häufiger rebased:

book/07-git-tools/sections/rewriting-history.asc

@@ -139,7 +139,7 @@ Wenn Sie speichern und den Editor verlassen, springt Git zum letzten Commit in d
 [source,console]
 ----
 $ git rebase -i HEAD~3
-Stopped at f7f3f6d... changed my name a bit
+Stopped at f7f3f6d... Change my name a bit
 You can amend the commit now, with
 
        git commit --amend

book/08-customizing-git/sections/config.asc

@@ -14,7 +14,7 @@ $ git config --global user.email [email protected]
 Jetzt lernen Sie einige der interessanteren Optionen kennen, die Sie auf diese Weise festlegen können, um Ihre Nutzung von Git zu optimieren.
 
 Zunächst eine kleine Übersicht: Git verwendet eine Reihe von Konfigurationsdateien, um das Standard-Verhalten, wie gewünscht, zu verändern.
-Die erste Option, in der Git nach solchen Werten sucht, ist die globale Datei `/etc/gitconfig`, die Einstellungen enthält, die auf jeden Benutzer auf dem System und alle seine Repositorys angewendet werden.
+Die erste Option, in der Git nach solchen Werten sucht, ist die globale Datei `[path]/etc/gitconfig`, die Einstellungen enthält, die auf jeden Benutzer auf dem System und alle seine Repositorys angewendet werden.
 Wenn Sie die Option `--system` an `git config` übergeben, wird diese Datei gezielt ausgelesen und geschrieben.
 
 Der nächste Ort, an dem Git nachschaut, ist die Datei `~/.gitconfig` (oder `~/.config/git/config`), die für jeden Benutzer spezifisch ist.
@@ -24,7 +24,7 @@ Schließlich sucht Git nach Informationen in der Konfigurations-Datei im Git-Ver
 Diese Werte sind spezifisch für dieses spezielle Repository und werden bei Übergabe der Option `--local` an `git config` angewendet.
 Wenn Sie nicht angeben, welchen Level Sie ansprechen möchten, ist das die Voreinstellung.
 
-Jeder dieser „Level“ (system, global, lokal) überschreibt Werte der vorigen Ebene. Daher werden beispielsweise Werte in `.git/config` jene in `/etc/gitconfig` überschreiben.
+Jeder dieser „Level“ (system, global, lokal) überschreibt Werte der vorigen Ebene. Daher werden beispielsweise Werte in `.git/config` jene in `[path]/etc/gitconfig` überschreiben.
 
 [NOTE]
 ====
@@ -175,7 +175,7 @@ Wenn Sie einen Befehl vertippen, zeigt das System Ihnen so etwas wie das hier:
 $ git chekcout master
 git: 'chekcout' is not a git command. See 'git --help'.
 
-Did you mean this?
+The most similar command is
     checkout
 ----