Wie trage ich Code zu Joomla bei?

19

Mir ist bekannt, dass der Code unter https://github.com/joomla/joomla-cms verwaltet wird (zumindest für das CMS) und dass ich Pull-Anfragen senden sollte, um vorzuschlagen, dass der Code hinzugefügt wird.

Ich bin besonders an guten Tipps interessiert, wie ich meine Beiträge verwalten und sicherstellen kann, dass der Code an der richtigen Stelle ankommt.

Sollte ich in meinem Forked Repo verschiedene Filialen verwenden, um verschiedene Beiträge zu verwalten? Wenn ja, wie kann man diesen Zweig am besten wieder mit den Hauptzweigen im Joomla-Repo verknüpfen?

Gibt es eine gute Methode, um meine gabelte Kopie auf dem neuesten Stand zu halten?

Vorschläge zu einem guten Ablauf für die Verwaltung dieses Prozesses wären sehr hilfreich!

David Fritsch
quelle

Antworten:

10

Es ist immer gut, für jede Pull-Anfrage, die Sie stellen, eine eigene Filiale zu haben.

Eine der einfachsten Möglichkeiten, einen aktuellen neuen Zweig zu erstellen, besteht darin, die Datei im ursprünglichen Repository mit der GitHub-Web-GUI zu bearbeiten. Beim Speichern erstellt GitHub automatisch einen neuen Zweig in Ihrem Zweig, basierend auf dem Zweig, den Sie gerade bearbeiten. Wenn Sie weitere Dateien bearbeiten möchten, können Sie diese in Ihrem neu erstellten und aktuellen Zweig bearbeiten.

Wenn Sie mit Git ein wenig vertraut sind, bauen Sie Ihren Zweig mit gegabelter Staging-Funktion auf dem ursprünglichen Zweig auf, damit er synchronisiert ist, bevor Sie neue Zweige erstellen. Auch wenn Sie einen PR aktualisieren müssen, wird empfohlen, ihn neu zu installieren, anstatt den Master zusammenzuführen. Während beide Methoden funktionieren, führen Merge-Commits nur zu einer schlechten Historie und sind schwerer zu quetschen.

Im Allgemeinen sollten PRs "atomar" sein. Das bedeutet, wenn Sie versuchen, etwas zu beheben, beheben Sie nur diesen bestimmten Fehler. Beheben Sie nicht zwei verschiedene Fehler in derselben PR und korrigieren Sie auch nicht den Codestyle. Es ist einfacher zu testen und es ist auch weniger wahrscheinlich, dass Konflikte entstehen, wenn die PR etwas länger als erwartet lebt.

Und natürlich fügen Sie eine gute Beschreibung der gewünschten Aktionen und Testanweisungen hinzu, um das Problem zu reproduzieren und Ihre Fehlerbehebung zu testen :-)

Bakual
quelle
4

Eine große Hilfe bei der Gruppierung Ihrer Beiträge besteht darin, jeden Beitrag in eine separate, entsprechend benannte Zweigstelle zu verschieben. Wenn Sie ein Feature hinzufügen, verwenden Sie ein Präfix wie feature-und fügen Sie eine ein oder zwei Wörter lange Featurebeschreibung für den Zweignamen hinzu. Wenn es sich um eine Fehlerbehebung in der JFormKlasse handelt, verwenden Sie bugfix-jform. Dies macht es wirklich einfach zu identifizieren, woran Sie arbeiten, indem Sie Ihre Git-Zweige über überprüfen git branch -a.

Don Gilbert
quelle