From 57e004e50f2605a3c72b449f8c2453210285fcb2 Mon Sep 17 00:00:00 2001
From: Johannes Keyser <johannes.keyser@sport.uni-giessen.de>
Date: Wed, 30 Mar 2022 18:57:04 +0200
Subject: [PATCH] Leichte Umstrukturierung und mehr Beispiele zu #18

---
 de/Hilfe.md | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/de/Hilfe.md b/de/Hilfe.md
index d176ca4..1f952d7 100644
--- a/de/Hilfe.md
+++ b/de/Hilfe.md
@@ -119,10 +119,13 @@ Sie werden analog zu einem persönlichen Token benutzt, aber erlauben eine zusä
 Um ein persönliches Access Token (PAT) erstellen zu können, melden Sie sich per Browser an, klicken Sie rechts oben auf ihr Profil, wählen Sie *Edit profile* und anschließend *Access Tokens* im linken Seitenmenü.
 Alternativ können Sie auf auf [diesen Direktlink](https://gitlab.ub.uni-giessen.de/-/profile/personal_access_tokens) klicken.
 
+Beachten Sie, dass Sie mehrere PATs für unterschiedliche Einsatzzwecke erstellen können; beispielsweise eins für ihr Laptop und ein anderes mit weniger Berechtigungen und früherem Ablaufdatum für einen Laborrechner.
+
 Um ein PAT zu erstellen:
 
-1. Wählen Sie unter __Token name__ eine passende Bezeichnung für das Token.
+1. Wählen Sie unter __Token name__ eine passende Bezeichnung für das Token, beispielsweise den Namen des Gerätes, für das das Token bestimmt ist.
 2. Vergeben Sie nach Möglichkeit unter __Expiry date__ ein Verfallsdatum der Gültigkeit des Tokens.
+   Diese Abwägung hängt vom Einsatzzweck ab.
 3. Erlauben Sie die benötigten Berechtigungen für den Einsatzzweck des Tokens;
    beispielsweise genügt __write\_repository__ für den Lese- und Schreibzugriff auf alle ihre Git Repositories.
    Eine Übersicht möglicher Berechtigungen finden sie [hier](https://gitlab.ub.uni-giessen.de/help/user/profile/personal_access_tokens.md#personal-access-token-scopes).
@@ -130,7 +133,6 @@ Um ein PAT zu erstellen:
    Nun wird die eindeutige, zufällige Zeichenkette des neuen Tokens angezeigt, beispielsweise `aztGzZkCT-kGyRs1M6x1`.
    Da die Zeichenkette nur direkt nach dem Erstellen angezeigt wird, sollten Sie sie sofort [zur Verwendung sicher speichern (siehe unten)](#sicheres-speichern-und-verwenden-eines-access-tokens).
 
-Beachten Sie, dass Sie mehrere PATs für unterschiedliche Einsatzzwecke erstellen können; beispielsweise eins für ihr Laptop und ein anderes mit weniger Berechtigungen und früherem Ablaufdatum für einen Laborrechner.
 
 #### Sicheres Speichern und Verwenden eines Access Tokens
 
@@ -146,16 +148,17 @@ Durch die eingesetzte Verschlüsselung ist diese Methode nur für interaktives A
 
 Aktuelle Git-Versionen unterstützen das verschlüsselte Abspeichern Ihrer Anmeldeinformationen.
 Je nach Betriebssystem wird die Verschlüsselung von unterschiedlichen Hilfsprogrammen realisiert.
-Das konfigurierte Hilfsprogramm kann über `git config credential.helper` eingesehen und verändert werden.
 
-Für _Windows_ und _macOS_ gibt es sinnvolle Standardeinstellungen (`manager-core`, bzw. `osxkeychain`), um den systemeigenen verschlüsselten Speicher zu nutzen.
+Bei Installation des aktuellen, [offiziellen Git Clients](https://git-scm.com/) unter _Windows_ oder _macOS_ werden sichere Standardeinstellungen gesetzt, die den systemeigenen verschlüsselten Speicher nutzen.
+Hierzu ist von Ihnen keine Konfiguration nötig.
+Das konfigurierte Hilfsprogramm können Sie über `git config credential.helper` einsehen und verändern; die sichere Standardeinstellung für Windows ist `manager-core`, für macOS `osxkeychain`.
 
-Für Nutzende von _Linux_, oder falls Sie _Multifaktor-Authentisierung_ nutzen möchten, empfiehlt sich das Hilfsprogramm [*Git Credential Manager (GCM)*](https://github.com/GitCredentialManager/git-credential-manager#git-credential-manager).
+Für _Linux_, oder falls Sie _Multifaktor-Authentisierung_ nutzen möchten, empfiehlt sich das Hilfsprogramm [*Git Credential Manager (GCM)*](https://github.com/GitCredentialManager/git-credential-manager#git-credential-manager).
 Unter Linux müssen Sie sich nach [Installation und Konfiguration von *GCM*](https://github.com/GitCredentialManager/git-credential-manager#linux) außerdem für einen [*Credential Store* entscheiden](https://github.com/GitCredentialManager/git-credential-manager/blob/main/docs/credstores.md#credential-stores), beispielsweise für *SecretService*, per `git config --global credential.credentialStore secretservice`.
 
 ##### Token sicher speichern und verwenden
 
-Wenn die [Vorraussetzungen zum sicheren Speichern](##vorraussetzung-verschlüsselter-speicher-für-git-anmeldeinformationen) erfüllt sind und Sie ein [Token erstellt](#erstellen-eines-persönlichen-access-tokens) haben, bleiben nur zwei simple Schritte:
+Wenn die [Vorraussetzungen zum sicheren Speichern](##vorraussetzung-verschlüsselter-speicher-für-git-anmeldeinformationen) erfüllt sind und Sie ein [Token erstellt](#erstellen-eines-persönlichen-access-tokens) haben bleiben nur zwei Schritte zur Nutzung des Tokens:
 
 1. Starten Sie von ihrem Gerät eine beliebige Git-Aktion, die eine Authentifizierung bei GitLab über HTTPS erfordert; beispielsweise Lesezugriff auf ein privates Projekt per `git pull` oder `git clone`.
    Achten Sie dabei darauf eine HTTPS-URL zu nutzen, die mit `https://` startet (prüfen Sie im Zweifel die eingestellte Git-Remote URL).
-- 
GitLab