Als Lernende beitragen #

Exponential ist freie Software, die offen entwickelt wird, und Beiträge von Lernenden sind willkommen. Ein Beitrag lehrt Sie mehr als eine Übung, weil echte Menschen ihn begutachten und echte Benutzer davon profitieren. „Echte Beiträge sind das beste Portfolio, das Studierende haben können: Ein gemergter Pull Request ist ein öffentlicher Nachweis von Können“ (Partner für Studierende und Bildung).

Inhalt #

1. Arten von Beiträgen
2. Was Sie brauchen
3. Die Regeln
4. Wie die Begutachtung abläuft
5. Urheberrecht und Lizenzen
6. Wo Sie anfangen

Arten von Beiträgen #

Der Bereich für Unterstützer nennt weitere Wege zu helfen (Unterstützer: hier beginnen).

Was Sie brauchen #

• Ein kostenloses GitHub-Konto. Sie brauchen es, um ein Issue oder einen Pull Request zu eröffnen (Wenn etwas schiefgeht).
• Für Code: Git und eine Lerninstallation aus Git-Klonen (Aus Git-Klonen zum Lernen installieren).
• Zeit, um auf Anmerkungen aus der Begutachtung zu antworten.

Die Regeln #

Aus CONTRIBUTING.md im Wurzelverzeichnis des Kernels (Richtlinien für Mitwirkende):

• Lesen Sie zuerst den Verhaltenskodex; von allen Mitwirkenden wird erwartet, dass sie ihn einhalten.
• Arbeiten Sie immer auf einem neuen Branch; halten Sie jeden Pull Request fokussiert, eine Änderung pro Pull Request.
• Commit-Betreffzeilen beginnen mit dem, was die Änderung tut: Added: , Updated: , Fixed: , Removed: oder Renamed: .
• Folgen Sie den Coding-Standards und dem Stil der Dateien rund um Ihre Änderung.
• Halten Sie das Dateimanifest share/filelist.md5 aktuell (make manifest-fix); make hooks installiert einen Pre-Commit-Hook, der es, die PHP-Syntax und den Codestil prüft.
• Fügen Sie Tests hinzu, wo Sie können, und aktualisieren Sie bei Bedarf die Dokumentation.

Wie die Begutachtung abläuft #

CONTRIBUTING.md warnt: „Stellen Sie sich auf viele Runden der Begutachtung ein. 7x führt deutlich mehr Begutachtungsrunden als üblich durch, bevor es einen Commit oder Pull Request annimmt, manchmal Hunderte von Überarbeitungen … das ist kein Urteil über Sie.“

• Beantworten Sie jede Anmerkung im Pull Request, mit einer Änderung oder einer Begründung.
• Wenn ein Gutachter sagt, das Verhalten, das Sie geändert haben, sei eine negative Funktion, also gewollt oder Auslegungssache, und andere Websites verlassen sich darauf, dann erklären Sie Ihren Anwendungsfall und bieten Sie die Änderung als Option statt als neue Voreinstellung an.
• Fassen Sie Ihren Pull Request mit Squash zusammen und rebasen Sie ihn auf main, solange er offen ist, wie 7x es verlangt; einen Force-Push machen Sie nur auf den Branch Ihres eigenen Pull Requests (Mit Git entwickeln).
• Jede Begutachtungsrunde ist eine kostenlose Lektion von erfahrenen Entwicklern. Notieren Sie, was Sie gelernt haben, in Ihrem Lerntagebuch.

Urheberrecht und Lizenzen #

• Codebeiträge stehen unter der GNU GPL Version 2 oder später, wie der Rest von Exponential.
• Dokumentation ist freie Dokumentation unter der GNU FDL 1.3 oder später (Freie Dokumentation).
• Ein Codebeitrag zum Kernel wird erst gemergt, wenn sein Autor das Contributor Licensing Agreement unterzeichnet hat, mit dem der Autor das Urheberrecht an die Exponential Foundation und 7x überträgt. Lesen Sie Die CLA für Lernende, bevor Sie Kernel-Code einsenden. Ihre eigenen Erweiterungen sind davon nicht betroffen.

Wo Sie anfangen #

1. Wählen Sie die kleinste echte Aufgabe: einen Tippfehler, den Sie gefunden haben, einen Schritt, der bei Ihnen nicht funktioniert hat, eine Zeichenkette in Ihrer Sprache.
2. Folgen Sie Ihr erster Beitrag, Schritt für Schritt.
3. Fügen Sie den Link Ihrem Portfolio hinzu, sobald er gemergt ist (Ein Portfolio aufbauen).

Der Leitfaden der Fürsprecher Einen ersten Beitrag begleiten ist für Menschen geschrieben, die Ihnen helfen; wenn Sie ihn lesen, sehen Sie, wie eine gute erste Aufgabe aussieht.

Verwandte Seiten #

• Ihr erster Beitrag, Schritt für Schritt
• Die CLA für Lernende
• Zum Projekt beitragen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.