Skip to content

BRANCHING_MODEL.md

Latest commit

 

History

History
71 lines (49 loc) · 8.07 KB

BRANCHING_MODEL.md

File metadata and controls

71 lines (49 loc) · 8.07 KB
Raw

Branching & Release Model (Magyar)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

Az OmniRoute párhuzamos ciklusú kiadási modellt használ: az aktív ciklushoz egy külön release/vX.Y.Z ág tartozik, a main a közzétett kiadási vonal, a ciklus kiadásakor pedig egy módosíthatatlan vX.Y.Z címke készül. Teljesen megszokott, hogy commitok kerülnek a release/* ágakra és a main ágra is — ez nem tévedés.

A karbantartóknak szóló részletek a CLAUDE.md fájlban (21. szigorú szabály) és a RELEASE_CHECKLIST.md dokumentumban találhatók. Ez az oldal a közreműködőknek szóló nyilvános összefoglaló.

Rövid áttekintés

Hivatkozás Szerep
release/vX.Y.Z Aktív ciklus — az adott verzió napi fejlesztésének és PR-egyesítéseinek helye
main Közzétett kiadási vonal — a ciklust squash merge formájában kapja meg a kiadás közzétételekor
vX.Y.Z (címke) Kiadási jelölő — a kiadás pillanatában létrehozott, módosíthatatlan mutató arra, hogy „mi került kiadásra” 
flowchart LR
  A["feat/fix ág"] --> B["PR → release/vX.Y.Z"]
  B --> C["A release/vX.Y.Z csúcsa"]
  C --> D["A kiadási PR squash merge-dzsel → main"]
  D --> E["vX.Y.Z címke"]
  C --> F["Következő ciklus: a release/vX+1 a befagyasztott csúcsból indul"]
Loading

Melyik ágat célozza a PR-em?

Az aktív release/vX.Y.Z ágat célozd — ne a main ágat.

  1. Keresd meg a legmagasabb verziószámú nyitott release/v* ágat (a dokumentum írásakor például: release/v3.8.49).
  2. Hozd létre az ágadat annak csúcsából (git fetch, majd checkout / rebase erre).
  3. Nyisd meg a PR-t úgy, hogy base = az adott release/vX.Y.Z.

A main nem a napi integrációs ág. A main ágra nyitott PR-ok célágát általában módosítani kell az egyesítés előtt.

Kiadási befagyasztás (párhuzamos ciklusok)

Egy kiadás egyeztetésekor megnyitunk egy release-freeze címkével ellátott jelölő issue-t. Ez nem állítja le a fejlesztést:

  • A befagyasztott release/vX.Y.Z az adott kiadás kiadási felelőséhez tartozik.
  • A következő ciklus release/vX+1 ága a befagyasztott csúcsból indul, így a közreműködők továbbra is egyesíthetik munkájukat.
  • Azoknak a nyitott PR-oknak, amelyek még mindig a befagyasztott ágat célozzák, a célágát módosítani kell az aktív (legmagasabb verziószámú) release/v* ágra.

Mielőtt egy ágról azt feltételeznéd, hogy egyesíthető, ellenőrizd, van-e folyamatban kiadási befagyasztás:

gh issue list --repo diegosouzapw/OmniRoute --label release-freeze --state open

Az egyesítés működését (a tulajdonos által hozzáadott queue címke → Mergify) a MERGE_TRAIN.md dokumentálja.

Miért van szükség ágra és címkére is?

Elem Élettartam Cél
release/vX.Y.Z Folyamatban lévő ciklus Összegyűjti az ellenőrzött PR-okat, megőrzi a CI zöld állapotát, és a PR-ok alapágaként szolgál
vX.Y.Z címke Örökké Pontosan megjelöli az npm / GitHub Releases szolgáltatásban kiadott tartalmat

Az ág a műhely, a címke pedig a lezárt csomag. A main ágra történő squash merge után a következő ciklus a release/vX+1 ágon folytatódik, anélkül, hogy meg kellene várni az előző kiadási PR befejezését.

Kapcsolódó dokumentumok