Skip to content

BRANCHING_MODEL.md

Latest commit

 

History

History
81 lines (59 loc) · 7.5 KB

BRANCHING_MODEL.md

File metadata and controls

81 lines (59 loc) · 7.5 KB
Raw

Branching & Release Model (Hrvatski)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇺 hu · 🇦🇲 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

OmniRoute koristi model izdanja s paralelnim ciklusima: namjensku granu release/vX.Y.Z za aktivni ciklus, main za objavljenu liniju i nepromjenjivu oznaku vX.Y.Z kada se taj ciklus objavi. Očekivano je da se commitovi pojavljuju i na release/* i na main — nije riječ o zabuni.

Pojedinosti za održavatelje nalaze se u datoteci CLAUDE.md (Strogo pravilo br. 21) i RELEASE_CHECKLIST.md. Ova je stranica javni sažetak namijenjen doprinositeljima.

Ukratko

Referenca Uloga
release/vX.Y.Z Aktivni ciklus — svakodnevni razvoj i spajanje PR-ova za tu verziju
main Objavljena linija — prima ciklus putem squash spajanja kada se izdanje objavi
vX.Y.Z (oznaka) Oznaka objave — nepromjenjiv pokazivač na „ono što je objavljeno”, izrađen u trenutku izdavanja 
flowchart LR
  A["grana feat/fix"] --> B["PR → release/vX.Y.Z"]
  B --> C["vrh grane release/vX.Y.Z"]
  C --> D["PR izdanja spaja se squash postupkom → main"]
  D --> E["Oznaka vX.Y.Z"]
  C --> F["Sljedeći ciklus: release/vX+1 stvara se iz zamrznutog vrha"]
Loading

Koju granu treba ciljati moj PR?

Ciljajte aktivnu granu release/vX.Y.Z — ne main.

  1. Pronađite najvišu otvorenu granu release/v* (primjer u trenutku pisanja: release/v3.8.49).
  2. Izradite granu iz njezina vrha (git fetch + checkout / rebase na nju).
  3. Otvorite PR s postavkom base = ta grana release/vX.Y.Z.

main nije integracijska grana za svakodnevni rad. PR-ove otvorene prema grani main obično treba preusmjeriti prije spajanja.

Zamrzavanje izdanja (paralelni ciklusi)

Kada se izdanje usklađuje, otvara se označeni problem s oznakom release-freeze. To ne zaustavlja razvoj:

  • Zamrznuta grana release/vX.Y.Z pripada voditelju izdanja za tu objavu.
  • Grana sljedećeg ciklusa release/vX+1 stvara se iz zamrznutog vrha kako bi doprinositelji mogli nastaviti dodavati promjene.
  • Otvorene PR-ove koji još uvijek ciljaju zamrznutu granu treba preusmjeriti na aktivnu (najvišu) granu release/v*.

Prije nego što pretpostavite da se željena grana može spajati, provjerite postoji li aktivno zamrzavanje:

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

Mehanika spajanja (vlasnikova oznaka queue → Mergify) dokumentirana je u MERGE_TRAIN.md.

Zašto i grana i oznaka?

Artefakt Trajanje Svrha
release/vX.Y.Z Ciklus u tijeku Prikuplja pregledane PR-ove, održava uspješan CI i služi kao baza za PR-ove
Oznaka vX.Y.Z Zauvijek Označava točan sadržaj objavljen na npm-u / u GitHub Releases

Grana je radionica; oznaka je zapečaćeni paket. Nakon squash spajanja u main, sljedeći se ciklus nastavlja na grani release/vX+1 bez čekanja da se dovrši PR prethodnog izdanja.

Povezana dokumentacija