Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- contributing:branches [2023/01/02 21:14] – angelegt grische
+++ contributing:branches [2024/03/28 10:21] (aktuell) – Feedback von Defidoc 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 ====
 Dieser Branch nutzt eine stabile Version von Gluon.
-Meist wird der letzte Release von Gluon genutzt, manchmal jedoch ab ausführlich getestete Commits kurz vor/nach einem Gluon Release.
+Meist ist es das letzte Release von Gluon, manchmal jedoch auch mit ausführlich getesteten Commits kurz vor/nach einem neuen Gluon Release.
 === stable Releases ===
-Änderungen in diesem Branch werden nacheinander in den Releases für "experimental", "testing" und anschließend "stable" veröffentlich.
+Änderungen in diesem Branch werden nacheinander auf dem Autoupdater-Branch "experimental", "testing" und anschließend "stable" veröffentlich.
 Die Versionen folgen dem Schema
@@ Zeile 16: / Zeile 16: @@
 </code>
-Das Jahr und der Monat des Release werden nur inkrementiert, wenn 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 jeder Änderung erhöht, sofern die Änderungen nicht die zugehörige Gluon version erhöhen.
 ==== experimental (deprecated) ====
-Dieser Branch wird nicht mehr genutzt.
+//Dieser Branch wird nicht mehr genutzt.//
 ==== next ====
-Dieser Branch nutzt den aktuellen Entwicklungsstand von Gluon und ist daher bleeding-edge.
+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.
-<!-- TODO: define "entwicklungsstand von Gluon". Master? Next? -->
-Er wird genutzt um neue Entwicklungen in Gluon vor einem neuem (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.
+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.
 Oft werden auch infrastrukturelle Änderungen hier zuerst getestet bevor sie in den "stable" Branch portiert werden.
 === next Releases ===
-Änderungen in diesem Branch werden nacheinander in den Releases für "experimental", "testing" und anschließend "stable" veröffentlich.
+Änderungen in diesem Branch werden nur auf dem Autoupdater-Branch "next" veröffentlicht.
-Die Versionen folgen dem gleichen Schema wie stable release, haben jedoch den Postfix "next":
+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>.<Stable Version Inkrement>-next
+v<Jahr des Release>.<Monat des Releases>.<Version Inkrement>-next<ggf. Next-Inkrement>
 </code>
-Das Jahr und der Monat des Release werden nur inkrementiert, wenn die zugehörige Gluon Version geändert wurde.
+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.
-Das Inkrement wird bei jeder Änderung erhöht, sofern die Änderungen nicht die zugehörige Gluon version erhöhen.
-==== Legacy ====
+==== 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]].
+Dieser Branch enthält eine veraltete Firmware, welche für Migrationen noch älterer Versionen genutzt werden kann. Dabei wird von einer externen gleichaltrigen Version (bspw. FFDon) oder einer älteren Version auf die "legacy" Firmware migriert, was im Anschluss automatisch die Migration auf "stable" erlaubt (sofern solche Geräte überhaupt noch in "stable" unterstützt werden).
-Damit wäre es möglich kritische Sicherheitsupdates auf den alten, nicht mehr von FFMuc unterstützen Geräten auszurollen.
+Nach aktuellem Stand (Q1 2024) werden in dieser Version auch noch [[https://ffmuc.net/freifunkmuc/2019/07/11/austausch-aelterer-geraete|4/32 Geräte (<=4MB Flash oder <=32MB RAM) unterstützt]].
+**⚠️ Dieser Branch bekommt generell keine Sicherheitsupdates und wird nicht mehr gepflegt!** Ausnahmefälle für Updates sind bspw. Migrationsskripte von anderen Firmware Versionen, um diese auf die "stable" Firmware migrieren zu können.
 ==== Tags ====
 [[https://github.com/freifunkMUC/site-ffm/tags|Liste der Tags im GitHub]]