Dokumentation der erforderlichen GitHub Token Berechtigungen (Fine-grained Tokens)

[Copilot]

Problem

Benutzer waren unsicher, welche Berechtigungen für GitHub Personal Access Tokens erforderlich sind. Die bisherige Dokumentation war zu knapp und ließ viele Fragen offen, insbesondere:

• Welche spezifischen Berechtigungen werden benötigt?
• Wo müssen Read/Write-Rechte gesetzt werden?
• Welche der vielen verfügbaren Berechtigungen (Codespaces, Copilot, GPG keys, Gists, etc.) sind tatsächlich notwendig?

Lösung

Diese PR fügt umfassende Dokumentation zu GitHub Token Berechtigungen hinzu und verwendet die modernen Fine-grained tokens (empfohlener Standard):

README.md

Erweitert die Token-Sektion von 3 auf 48 Zeilen mit:

• Klare Anwendungsfälle: Wann wird ein Token benötigt (private Repos, Rate-Limits, Upload)
• Schritt-für-Schritt Anleitung: Genauer Pfad zur Token-Erstellung mit Fine-grained tokens
• Repository Access: Auswahl zwischen allen Repositories oder spezifischen Repositories
• Erforderliche Berechtigungen (Repository permissions):
  • ✅ Contents: Read-only (zum Installieren) oder Read and write (zum Hochladen)
  • ✅ Metadata: Read-only (automatisch gesetzt)
• NICHT erforderliche Berechtigungen (explizite Liste):
  • ❌ Actions
  • ❌ Administration
  • ❌ Codespaces
  • ❌ Commit statuses
  • ❌ Discussions
  • ❌ Environments
  • ❌ Issues
  • ❌ Pull requests
  • ❌ etc.
• Sicherheitshinweise: Best Practices für Token-Verwaltung inkl. Ablaufdatum-Empfehlung (90 Tage)

Sprachdateien (de_de.lang & en_gb.lang)

• Erweiterte github_token_help mit Fine-grained token Berechtigungsanforderungen
• Neue github_token_create_info mit Navigationspfad zu Fine-grained tokens
• Beide Sprachen (Deutsch & Englisch) aktualisiert

Settings-Seite (pages/settings.php)

• Zeigt die erweiterten Hilfstexte direkt in der Admin-Oberfläche
• Nutzer sehen die Informationen dort, wo sie den Token konfigurieren

Ergebnis

Benutzer haben jetzt:

• Präzise Anweisungen für moderne Fine-grained tokens (sicherer als Classic tokens)
• Granulare Berechtigungen, welche aktiviert werden müssen (Contents + Metadata)
• Klare Abgrenzung, welche Berechtigungen NICHT benötigt werden
• Security Best Practices für sicheren Token-Umgang mit Ablaufdatum
• Mehrsprachige Dokumentation (Deutsch & Englisch)

Fixes Issue über Token-Berechtigungen

Fixes #2

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Token Rechte</issue_title>
<issue_description>Es ist nicht klar, welche Rechte man dem Token zuordnen muss damit es geht. Bitte noch mal genauer erläutern.

Block another user
Codespaces user secrets
Copilot Chat
Copilot Editor Context
Copilot Requests
Email addresses
Events
Followers
GPG keys
Gists
Git SSH keys
Interaction limits
Knowledge bases
Models
Plan
Private repository invitations
Profile
SSH signing keys
Starring
Watching

welche brauche ich und wo muss ich read und write rechte setzen? </issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #2

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

Pull Request Overview

This PR adds comprehensive documentation for GitHub Personal Access Token permissions to address user confusion about required token permissions. The documentation clarifies which specific permissions are needed and which are not required.

• Expanded token documentation from 3 to 48 lines in README.md with detailed permission requirements
• Added new translation keys in both German and English language files for enhanced token guidance
• Updated settings page to display additional token creation instructions

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
README.md	Comprehensive expansion of GitHub token section with detailed permission requirements and security best practices
lang/de_de.lang	Added German translations for enhanced token help text and creation instructions
lang/en_gb.lang	Added English translations for enhanced token help text and creation instructions
pages/settings.php	Updated to display additional token creation guidance in the admin interface

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[skerbis]

nicht classic oder? fine granted @copilot

[Copilot]

nicht classic oder? fine granted @copilot

Richtig, habe die Dokumentation auf fine-grained tokens umgestellt. Diese sind sicherer und moderner als classic tokens. Die erforderlichen Berechtigungen sind jetzt:

• Contents: Read-only (zum Installieren) oder Read and write (zum Hochladen)
• Metadata: Read-only (automatisch)

Commit: 2c0b1db → [aktualisiert]