Ihr erster Beitrag, Schritt für Schritt #

Diese Seite führt Sie durch einen ersten Beitrag. Wählen Sie den Weg, der zu dem passt, was Sie gefunden haben. Alle Wege enden in einem Pull Request, der öffentlich begutachtet wird.

Inhalt #

1. Eine kleine, echte Aufgabe wählen
2. Weg A: eine Korrektur der Dokumentation
3. Weg B: eine Übersetzung
4. Weg C: eine Codekorrektur
5. Den Pull Request schreiben
6. Nachdem Sie ihn eingesendet haben

Eine kleine, echte Aufgabe wählen #

Gute erste Aufgaben, nach Einen ersten Beitrag begleiten:

• ein Tippfehler oder ein veralteter Schritt in einer Hilfeseite, die Sie gelesen haben;
• ein fehlender Link auf eine weiterführende Seite;
• eine Handvoll Zeichenketten in Ihrer Sprache;
• ein kleiner Fehler, auf den Sie selbst gestoßen sind, mit einer klaren Lösung.

Vermeiden Sie „Übungs“-Pull-Requests ohne echte Änderung und große Aufgaben. Der erste sollte in ein bis zwei Stunden fertig sein. Durchsuchen Sie zuerst den Issue-Tracker: Wenn Ihr Problem bekannt ist, ergänzen Sie dieses Issue um das, was Sie wissen.

Weg A: eine Korrektur der Dokumentation #

1. Drücken Sie auf der Hilfeseite Auf GitHub bearbeiten (Dokumentation beitragen).
2. Ändern Sie den Text im Browser. Behalten Sie den Stil der Seite bei: amerikanisches Englisch, „Exponential“ für das Produkt, eine Quelle für jede Angabe.
3. Schreiben Sie eine Commit-Nachricht wie Fixed: The languages help names the Apply button.
4. Schlagen Sie die Änderung vor und eröffnen Sie den Pull Request.

Die Hilfeseiten sind die Dateien in doc/ des Kernels, eine Korrektur der Dokumentation ist also ein Pull Request an se7enxweb/exponential. Mehr: Die Hilfe als Lernende verbessern.

Weg B: eine Übersetzung #

1. Prüfen Sie die Vollständigkeit der Sprache in doc/eng-us/languages.md.
2. Forken Sie das Repository und öffnen Sie share/translations/<locale>/translation.ts.
3. Übersetzen Sie nicht übersetzte oder unfertige Meldungen; behalten Sie Platzhalter wie %1 genau bei.
4. Stellen Sie die Administrationsoberfläche auf Ihre Sprache um und sehen Sie sich die Bildschirme an, die Sie übersetzt haben.
5. Committen Sie mit einer Betreffzeile wie Updated: German translation of the help dashboard und eröffnen Sie einen Pull Request.

Quelle: Übersetzungen beitragen. Mehr: Als Lernende übersetzen.

Weg C: eine Codekorrektur #

Nach Mit Git entwickeln, für eine Erweiterung wie eztags (beim Kernel funktioniert es genauso):

1. Öffnen Sie das Repository auf GitHub und drücken Sie Fork.

2. Fügen Sie Ihren Fork als zweites Remote hinzu und beginnen Sie einen Branch:

   cd extension/eztags
   git remote add fork https://github.com/<you>/eztags.git
   git switch -c fix-tag-search

3. Nehmen Sie die Änderung vor, testen Sie sie auf Ihrer Lernwebsite und committen Sie sie:

   git commit -am "Fixed: The tag search finds tags with an apostrophe"
   git push -u fork fix-tag-search

4. Folgen Sie dem Link, den GitHub ausgibt, um einen Pull Request zu eröffnen (oder gh pr create).

Lesen Sie für den Kernel selbst zuerst CONTRIBUTING.md: Führen Sie einmal make hooks aus, halten Sie share/filelist.md5 mit make manifest-fix aktuell und sorgen Sie dafür, dass Ihre unterzeichnete CLA vor dem Merge hinterlegt ist (Die CLA für Lernende).

Den Pull Request schreiben #

Title:    Fixed: <what the change does, in one line>

What:     <the problem, in two sentences>
Why:      <who it affects>
How I tested it:
          <release, PHP version, steps, what I saw before and after>
CLA:      <signed / not needed (documentation fix in an extension of my own, etc.)>

Die Vorlage für Pull Requests des Kernels hat ein Kontrollkästchen für die CLA. Halten Sie personenbezogene Daten, Passwörter und Serverangaben aus der Beschreibung und den Screenshots heraus.

Wählen Sie für einen ersten Beitrag eine Korrektur, gegen die niemand etwas haben kann. Wenn das Verhalten, das Sie ändern möchten, gewollt oder Auslegungssache sein könnte, ist es vielleicht eine negative Funktion, auf die sich andere Websites verlassen: Eine solche Änderung braucht ein starkes „Warum“, wird besser als Option statt als neue Voreinstellung angeboten und kann mehrere Begutachtungsrunden dauern, bevor sie gemergt wird.

Nachdem Sie ihn eingesendet haben #

• Rechnen Sie mit Begutachtungsrunden. 7x begutachtet in viel mehr Runden als üblich; das „ist kein Urteil über Sie“ (Richtlinien für Mitwirkende).
• Beantworten Sie jede Anmerkung im Pull Request.
• Fassen Sie mit Squash zusammen und rebasen Sie auf main, wenn Sie darum gebeten werden: git fetch origin, git rebase -i origin/main, git push --force-with-lease, nur auf den Branch Ihres Pull Requests.
• Wenn er gemergt ist, nehmen Sie ihn in Ihr Portfolio und Ihr Tagebuch auf. Wählen Sie dann die nächste Aufgabe.

Verwandte Seiten #

• Als Lernende beitragen
• Git als Lernende nutzen
• Mit Git entwickeln
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.