GitHub für Fürsprecher
Diese Seite ist für Fürsprecher, die neu bei GitHub sind, und für Entwickler, die es als Fürsprecher nutzen möchten, nicht nur zum Programmieren. Exponential lebt auf GitHub unter dem Konto se7enxweb: der Kernel, die Erweiterungen, Velocity und der Community-Tracker. Für Issues und Pull Requests brauchen Sie ein kostenloses GitHub-Konto (Wenn etwas schiefgeht).
Inhalt
- Die Repositorys, die Sie nutzen werden
- Verfolgen, was passiert
- Issues: lesen, kommentieren, reagieren
- Pull Requests
- Helfen ohne Code
- Sicherheit auf GitHub
Die Repositorys, die Sie nutzen werden
| Repository | Verwendung |
|---|---|
| se7enxweb/exponential | Der Kernel, die Administration, die mitgelieferten Erweiterungen und die Dokumentation (diese Hilfe liegt in doc/) |
| se7enxweb/exponential-velocity | Der Velocity-Server |
| se7enxweb/exponential-community | Das Projekt, die Website, das Ökosystem, Ideen |
| Das eigene Repository jeder Erweiterung | Ihr Code und ihre Issues; die Seite Fehler melden der Hilfe listet sie auf |
Verfolgen, was passiert
- Watch > Custom > Releases bei einem Repository, um nur über neue Releases benachrichtigt zu werden.
- Die Seite der Releases listet die veröffentlichten Versionen auf.
- Die Liste der Commits auf
mainzeigt die tägliche Arbeit; die Geschichte erklärt sie Monat für Monat. - Schalten Sie Benachrichtigungen nicht für alles ein, es sei denn, Sie möchten Hunderte E-Mails.
Issues: lesen, kommentieren, reagieren
| Tun Sie | Tun Sie nicht |
|---|---|
| Suchen, bevor Sie ein neues Issue eröffnen | Ein Duplikat eröffnen |
| Einem bestehenden Issue neue Informationen hinzufügen: Ihre Version, eine Nachstellung | „+1“ oder „bei mir auch“ kommentieren (nutzen Sie stattdessen eine Reaktion) |
| Mit einem Daumen-hoch zeigen, dass das Issue Sie betrifft | Immer wieder „Gibt es Neuigkeiten?“ fragen |
| Konkret und freundlich sein | Eine Korrektur oder einen Termin fordern |
| Verwandte Issues und Forendiskussionen verlinken | Logs mit personenbezogenen Daten oder Geheimnissen einfügen |
Wie Sie ein gutes Issue schreiben: Fehler gut melden. Welches Repository: Welcher Tracker für welche Meldung.
Pull Requests
- Dokumentation: Auf GitHub bearbeiten auf jeder Hilfeseite öffnet die Datei; GitHub forkt das Repository für Sie (Die Hilfe verbessern).
- Code: forken, Branch anlegen, committen, Pull Request (Mit Git entwickeln).
- Übertragung des Urheberrechts (CLA): Ein Code-Beitrag zum Kernel (
se7enxweb/exponential), in welcher Form auch immer, wird erst übernommen, wenn das unterzeichnete Contributor Licensing Agreement seines Autors eingegangen ist. Mit Unterschrift und Einreichung übertragen Sie das Urheberrecht an Ihrem Beitrag an 7x, das damit sein Eigentümer wird, und geben die Kontrolle darüber ab: 7x darf ihn auf jede Weise verwenden, ändern, neu lizenzieren und verbreiten, ohne Sie zu fragen oder zu bezahlen, und Sie können ihn nicht zurückziehen (Übertragung des Urheberrechts (CLA)). Ihre eigenen Erweiterungen sind nicht betroffen. - Commit-Nachrichten beginnen mit
Added:,Updated:,Fixed:,Removed:oderRenamed:(CONTRIBUTING.md). - Jeder Pull Request wird übernommen. Solange er offen ist, fasst sein Autor ihn zusammen (Squash) und setzt ihn
per Rebase auf
mainauf, wie es die Reviews verlangen; sobald er übernommen ist, wirdmainnie umgeschrieben, und spätere Korrekturen kommen als neue Pull Requests (Wie das Projekt wächst).
Helfen ohne Code
| Hilfe | Wie |
|---|---|
| Einen Fehler bestätigen | Ihn auf Ihrer Installation nachstellen und mit Ihrer Umgebung kommentieren (Issues nachstellen und bestätigen) |
| Ein Issue verbessern | Schritte, ein kleineres Beispiel, die genaue Meldung ergänzen |
| Einen Pull Request testen | Die Änderung auf einer Testinstallation ausprobieren und berichten, was Sie gesehen haben |
| Dokumentation prüfen | Einen Pull Request zur Dokumentation auf Klarheit und Namen lesen |
| Übersetzen | Pull Requests zu den Übersetzungsdateien (Bei Übersetzungen helfen) |
| Erstmals Beitragende willkommen heißen | Ein freundlicher Kommentar zu ihrem ersten Pull Request |
Sicherheit auf GitHub
- Alles in einem öffentlichen Repository ist für immer öffentlich, auch Text, der später wegbearbeitet wurde, in der Historie.
- Stellen Sie nie Passwörter, Schlüssel, Cookies, Datenbankadressen oder personenbezogene Daten in Issues, Kommentare oder Code.
- Sicherheitsprobleme gehören nie in ein öffentliches Issue: Nutzen Sie den vertraulichen Weg aus
SECURITY.md(Sicherheitsmeldungen bleiben vertraulich). - Schalten Sie für Ihr GitHub-Konto die Zwei-Faktor-Authentifizierung ein.
Verwandte Seiten
- Welcher Tracker für welche Meldung
- Einen ersten Beitrag begleiten
- Mit Git entwickeln
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.