Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- contributing:branches [2023/01/09 14:28] – [stable] goligo
+++ contributing:branches [2024/11/28 11:51] (aktuell) – formatting grische
@@ Zeile 1: / Zeile 1: @@
 ===== Branches & Tags =====
-Es gibt im GitHub-Repository diverse Branches. In dem Artikel werden die verschiedenen Branches und deren Nutzung beschrieben.
+Es gibt im GitHub-Repository diverse Branches. In diesem Artikel werden die verschiedenen Branches und deren Nutzung beschrieben.
-==== stable ====
+==== Deprecated Branches ====
-Dieser Branch nutzt eine stabile Version von Gluon.
+Vor 2025 gab es Branches "stable", "next" und "legacy" um verschiedene Versionen von Gluon parallel pflegen zu können und gleichzeitig Upgrade Pfade zwischen den Versionen zu gewährleisten.
-Meist wird der letzte Release von Gluon genutzt, manchmal jedoch ab ausführlich getestete Commits kurz vor/nach einem Gluon Release.
+Da dies jedoch zu vereinfacht ist für die immer komplexer werdenden [[https://github.com/freifunk-gluon/gluon/wiki/Release-life-cycle#migration-paths-diagram|Upgrade Pfade von Gluon]], wurden diese Branches deprecated.
+Davor gab es auch noch einen "experimental" Branch, dieser wird aber seit 2021 nicht mehr genutzt.
+==== Stable Gluon ====
+Die Branches ''gluon-v20...'' enthalten Firmware Versionen für die stabilen [[https://github.com/freifunk-gluon/gluon/branches/all|Versionen (bzw. Branches) von Gluon]] mit zusätzlichen Patches für FFMuc.
+Beispielsweise ''gluon-v2021.1.x'' enthält eine Version die auch noch [[https://ffmuc.net/freifunkmuc/2019/07/11/austausch-aelterer-geraete|4/32 Geräte (<=4MB Flash oder <=32MB RAM) unterstützt]].
+**⚠️ Alle Branches außer der neuesten Version bekommen generell keine Sicherheitsupdates und werden nicht mehr aktiv gepflegt! ⚠️**\\
+ Ausnahmefälle für Updates in älteren Branches sind bspw. Migrationsskripte, um die diversen Upgrade Pfade auf die neueste Firmware Version gewährleisten zu können.
+=== Stable Releases ===
-=== stable Releases ===
 Änderungen in diesem Branch werden nacheinander auf dem Autoupdater-Branch "experimental", "testing" und anschließend "stable" veröffentlich.
@@ Zeile 16: / Zeile 29: @@
 </code>
-Das Jahr und der Monat des Release werden inkrementiert, wenn es sich um eine grundlegende oder grössere Änderung handelt, z.B. sich die Gateways geändert haben, ein neues Segment hinzugefügt oder die zugehörige Gluon Version geändert wurde.
+Das Jahr und der Monat des Release werden bei jedem Release inkrementiert, unabhängig von Größe der Änderung. Das Inkrement wird bei Änderungen erhöht die im gleichen Monat stattfinden.
-Das Inkrement wird bei Änderungen erhöht, bei denen es sich lediglich um Bugfixes handelt, aber die keine Funktionalität ändern oder Neue hinzufügen.
-==== experimental (deprecated) ====
-Dieser Branch wird nicht mehr genutzt.
+==== Next Gluon ====
-==== next ====
+Ein spezieller Branch ist ''gluon-next'', welcher den bleeding-edge ''next'' Branch von Gluon referenziert. Dieser Branch wird meist force-pushed (analog dem Next Branch von Gluon) und sollte nur in Ausnahmefällen benutzt werden.
-Dieser Branch nutzt den aktuellen Entwicklungsstand von Gluon und ist daher bleeding-edge. Je nachdem was gerade benötigt wird, kann er entweder auf dem master- oder dem next-Branch von Gluon aufbauen.
+Er wird genutzt um neue Entwicklungen in Gluon vor einem neuen (major) Gluon Release bei FFMuc testen zu können und erlaubt Entwicklern, bereits früh Änderungen bei der FFMuc Firmware anzustoßen, um kompatibel mit dem nächsten Gluon Release zu bleiben.
-Er wird genutzt um neue Entwicklungen in Gluon vor einem neuen (major) Gluon Release mit FFMuc testen zu können und erlaubt Entwicklern bereits früh Änderungen in FFMuc anzustoßen um kompatibel mit dem nächsten Gluon Release zu bleiben.
+Oft werden auch infrastrukturelle Änderungen hier zuerst getestet bevor sie in die entsprechenden "stable" Branches portiert werden.
-Oft werden auch infrastrukturelle Änderungen hier zuerst getestet bevor sie in den "stable" Branch portiert werden.
-=== next Releases ===
+=== Next Releases ===
-Änderungen in diesem Branch werden nur auf dem Autoupdater-Branch "next" veröffentlich.
-Die Versionen folgen der aktuellen Versionsnummer von stable, haben jedoch den Postfix "next", mit einem zusätzlichen Next-Inkrement:
+Die Versionen folgen der aktuellen Versionsnummer von "stable", haben jedoch den Postfix "next", ggf. mit einem zusätzlichen Next-Inkrement:
 <code>
-v<Jahr des Release>.<Monat des Releases>.<Version Inkrement>-next<Next Inkrement>
+v<Jahr des Release>.<Monat des Releases>.<Version Inkrement>-next<ggf. Next-Inkrement>
 </code>
-Das erste Next-Release nach dem letzten Stable-Release bekommt den Next-Inkrement "1". Bei allen weiteren Next-Releases wird der Next-Inkrement um eins hochgezählt. Die Kopplung der Versionsnummer an das aktuelle Stable-Release ist bewusst, unabhängig von der OpenWrt-Version oder den Umfang der Änderungen im Vergleich zu stable, da diese für unsere Benutzer eine untergeordnete Bedeutung haben.
+Ein "next"-Release bekommt die Versionsnummer des "stable"-Release auf dem "next" basiert mit einem ''-next'' Postfix. Sollte es mehrere "next" Releases geben, die auf dem gleichen "stable"-Stand basieren, dann wird nach dem Postfix ein Next-Inkrement (beginnend bei "2") angehängt. Bei allen weiteren Next-Releases wird das Next-Inkrement um eins hochgezählt. Die Kopplung der Versionsnummer an das aktuelle "stable"-Release ist bewusst gewählt, unabhängig von der OpenWrt-Version oder den Umfang der Änderungen im Vergleich zum Stand des "stable" Branches, da diese für unsere Benutzer meist eine untergeordnete Bedeutung haben.
-==== legacy ====
-Aktuell nicht genutzter Branch, welcher auf dem letzten Stand der Firmware ist, die noch [[https://ffmuc.net/freifunkmuc/2019/07/11/austausch-aelterer-geraete|4/32 Geräte (<=4MB Flash oder <=32MB RAM) unterstützt]].
-Damit wäre es möglich kritische Sicherheitsupdates auf den alten, nicht mehr von FFMuc unterstützen Geräten auszurollen.
 ==== Tags ====
 [[https://github.com/freifunkMUC/site-ffm/tags|Liste der Tags im GitHub]]