contributing:branches

Dies ist eine alte Version des Dokuments!


Es gibt im GitHub-Repository diverse Branches. In dem Artikel werden die verschiedenen Branches und deren Nutzung beschrieben.

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.

stable Releases

Änderungen in diesem Branch werden nacheinander auf dem Autoupdater-Branch „experimental“, „testing“ und anschließend „stable“ veröffentlich.

Die Versionen folgen dem Schema

v<Jahr des Release>.<Monat des Releases>.<Version Inkrement>

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.

Dieser Branch wird nicht mehr genutzt.

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 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 den „stable“ Branch portiert werden.

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“, ggf. mit einem zusätzlichen Next-Inkrement:

v<Jahr des Release>.<Monat des Releases>.<Version Inkrement>-next<ggf. Next Inkrement>

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 werden nach dem Postfix ein Next-Inkrement (beginnend bei „2“) angehängt. 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 meist eine untergeordnete Bedeutung haben.

Dieser Branch enthält eine veraltete Firmware, welche für Migrationen noch älterer Versionen genutzt werden kann. Dabei wird von einer externen gleichaltrigen (bspw. FFDon) oder älteren Version auf legacy migriert und erlaubt im Anschluss automatisch auf stable zu migrieren (sofern Geräte noch in stable unterstützt werden).

Nach aktuellem Stand (Q1 2024) werden in dieser Version auch noch 4/32 Geräte (<=4MB Flash oder <=32MB RAM) unterstützt.

⚠️ Dieser Branch bekommt generell keine Sicherheitsupdates und wird generell nicht mehr gepflegt! Ausnahmefälle für Updates sind bspw. Migrationsskripte von anderen Firmware Versionen.

  • contributing/branches.1711569135.txt.gz
  • Zuletzt geändert: 2024/03/27 19:52
  • von grische