Git als Lernende nutzen #

Mit Git wird Exponential entwickelt, installiert (als Klone) und verbessert. Diese Seite zeigt, wie Lernende es täglich nutzen. Die vollständige Anleitung ist Mit Git entwickeln; die Befehle sind in der Git-Kurzreferenz für Lernende gesammelt.

Inhalt #

1. Drei Repositorys, die Lernende führen
2. Tägliche Gewohnheiten
3. Aus der Historie lernen
4. Commit-Nachrichten
5. Geheimnisse heraushalten
6. Auf dem neuesten Stand bleiben

Drei Repositorys, die Lernende führen #

Die Erweiterungen, die Composer installiert, sind ebenfalls eigene Repositorys; git status im Wurzelverzeichnis listet sie als nicht versionierte Ordner auf, was so erwartet ist (Mit Git entwickeln).

Tägliche Gewohnheiten #

1. Beginnen Sie die Sitzung mit git status in dem Repository, das Sie ändern werden.
2. Arbeiten Sie auf einem Branch, niemals direkt auf dem Tag eines anderen oder auf main des Projekts.
3. Committen Sie kleine Schritte mit klaren Nachrichten; ein Commit pro Idee.
4. Beenden Sie die Sitzung mit git status und git log --oneline -5: Ist alles committet?
5. Pushen Sie Ihre eigenen Repositorys auf Ihr eigenes Konto bei einem Git-Hoster, damit ein kaputter Laptop Ihre Arbeit nicht mitnimmt.

Aus der Historie lernen #

Die Historie des Kernels ist ein Lehrbuch, geschrieben von seinen Entwicklern. Aus Mit Git entwickeln:

git log --oneline -10 -- kernel/content/view.php   # the last ten changes to one file
git blame kernel/content/view.php                   # who last changed each line
git log -S "CheckValidity" --oneline                # every commit that added or removed a word

Übung: Wählen Sie eine Einstellung, der Sie in einem Lernprojekt begegnet sind, finden Sie mit git log -S den Commit, der sie eingeführt hat, und erklären Sie in Ihrem Tagebuch, warum sie hinzugefügt wurde.

Commit-Nachrichten #

Die Commit-Betreffzeilen des Projekts beginnen mit dem, was die Änderung tut: Added: , Updated: , Fixed: , Removed: oder Renamed: (Richtlinien für Mitwirkende). Verwenden Sie denselben Stil in Ihren eigenen Repositorys; das macht Ihre Historie lesbar und Ihre künftigen Pull Requests vertraut:

Added: The club event class and three sample events
Fixed: The event template escapes the title
Updated: The search test plan after the index rebuild

Geheimnisse heraushalten #

• Committen Sie niemals settings/override/ aus einer Installation, kickstart.ini (es enthält das Datenbankpasswort, Erste Schritte), API-Schlüssel oder Passwörter.
• Verwenden Sie in Ihren eigenen Repositorys eine .gitignore für Dateien, die lokal bleiben müssen.
• Wenn ein Geheimnis committet wurde, behandeln Sie es als öffentlich: Ändern Sie das Passwort oder widerrufen Sie den Schlüssel und entfernen Sie es dann aus dem Repository.

Auf dem neuesten Stand bleiben #

Zuerst Git (der Kernel), dann Composer (die Erweiterungen):

git fetch origin --tags
git merge origin/main
composer update

composer update, nicht composer install, weil sich die composer.json des Kernels geändert hat (Mit Git entwickeln). Der ganze Ablauf, mit der Datenbankhälfte eines Upgrades, steht in Mit Git aktualisieren. Wenn Composer sich wegen Ihrer eigenen Änderungen weigert, lesen Sie Wenn Composer sich weigert.

Verwandte Seiten #

• Git-Kurzreferenz für Lernende
• Mit Git entwickeln
• Ihr erster Beitrag, Schritt für Schritt
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.