Ihr erster Beitrag #

Wählen Sie einen der drei. Jeder dauert beim ersten Mal weniger als eine Stunde.

Inhalt #

1. Möglichkeit A: eine Hilfeseite korrigieren
2. Möglichkeit B: einen Fehler melden
3. Möglichkeit C: Ihr erster Pull Request mit Code
4. Nach Ihrem ersten Beitrag

Möglichkeit A: eine Hilfeseite korrigieren #

1. Legen Sie ein kostenloses GitHub-Konto an, falls Sie keines haben.
2. Folgen Sie auf der Hilfeseite mit dem Fehler dem Link Auf GitHub bearbeiten.
3. GitHub bietet an, das Repository zu forken; nehmen Sie an. Korrigieren Sie den Text im Browser.
4. Schreiben Sie eine kurze Commit-Nachricht, die mit dem beginnt, was die Änderung tut, zum Beispiel Updated: The help page on searching names the search filters correctly (die Präfixe sind Added:, Updated:, Fixed:, Removed:, Renamed:; CONTRIBUTING.md, „Making Changes“).
5. Schlagen Sie die Änderung als Pull Request vor und beschreiben Sie in einem Satz, was falsch war.

Das Repository führt ein Manifest aller Dateien, share/filelist.md5, und die CI prüft es. Schlägt die Prüfung bei Ihrem Pull Request fehl, „zeigt“ ihre Zusammenfassung „die zu ändernden Zeilen“ (CONTRIBUTING.md, „Submitting Changes“); eine prüfende Person kann helfen.

Möglichkeit B: einen Fehler melden #

1. Öffnen Sie Fehler melden in der Hilfe Ihrer Administration (exphelp/report). Die Seite „füllt eine Zusammenfassung der Installation für Sie aus und öffnet ein neues Issue mit vorbereitetem Titel und Text“ (Wenn etwas schiefgeht).
2. Durchsuchen Sie zuerst den Tracker; ist der Fehler bekannt, ergänzen Sie das vorhandene Issue um das, was Sie wissen.
3. Schreiben Sie die Schritte auf, was Sie erwartet haben und was geschehen ist. Entfernen Sie alles Private.
4. Beobachten Sie das Issue und beantworten Sie Fragen der Maintainer.

Manches Verhalten, das wie ein Fehler aussieht, ist gewollt oder auslegungsfähig, und andere Websites hängen davon ab. Wenn ein Maintainer es eine negative Funktion nennt, ist die Diskussion nicht beendet: Erklären Sie Ihren Anwendungsfall und rechnen Sie damit, dass eine Änderung als Option und erst nach sorgfältigem Review kommt.

Einen Fehler melden enthält die Einzelheiten.

Möglichkeit C: Ihr erster Pull Request mit Code #

1. Forken Sie se7enxweb/exponential und klonen Sie Ihren Fork.
2. Führen Sie composer install aus und richten Sie eine Testinstallation ein (Mit Git entwickeln).
3. Führen Sie einmal make hooks aus: Die Hooks prüfen die Commit-Nachricht, die PHP-Syntax, den Code-Stil und das Manifest (CONTRIBUTING.md, „Submitting Changes“).
4. Legen Sie einen Branch an, zum Beispiel git checkout -b fix/typo-in-setup-message.
5. Nehmen Sie eine kleine Änderung vor, testen Sie sie und committen Sie mit einer Nachricht mit Präfix.
6. Aktualisieren Sie das Manifest mit make manifest-fix, wenn Ihre Änderung eine Datei hinzufügt, ändert oder entfernt.
7. Pushen Sie in Ihren Fork und eröffnen Sie einen Pull Request. Kreuzen Sie das CLA-Kästchen der Vorlage an, sobald Ihr unterschriebenes CLA vorliegt (Das CLA erklärt).

Gute erste Änderungen: ein falscher Meldungstext, ein fehlender Übersetzungstext, ein defekter Link in einem Template, ein Test für einen Fehler, der bereits behoben ist.

Nach Ihrem ersten Beitrag #

• Rechnen Sie mit Fragen und mehreren Review-Runden; das ist normal (Reviews geben und erhalten).
• Notieren Sie, was Sie getan haben (Ihre Beiträge festhalten).
• Leisten Sie einen zweiten Beitrag im selben Bereich; durch Wiederholung werden Menschen zu vertrauenswürdigen Mitwirkenden (Vom Nutzer zum Mitwirkenden).

Verwandte Seiten #

• Als Community-Mitglied mitwirken
• Einen ersten Beitrag betreuen
• Mit Git entwickeln
• Wenn etwas schiefgeht
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.