Skip to content

BRANCHING_MODEL.md

Latest commit

 

History

History
69 lines (47 loc) · 7.57 KB

BRANCHING_MODEL.md

File metadata and controls

69 lines (47 loc) · 7.57 KB
Raw

Branching & Release Model (Eesti)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 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 kasutab paralleeltsükli väljalaskemudelit: aktiivse tsükli jaoks on eraldi haru release/vX.Y.Z, avaldatud versioonirea jaoks main ning tsükli väljalaskmisel muutumatu märgend vX.Y.Z. On ootuspärane, et commit'id jõuavad nii harudesse release/* kui ka harusse main — see ei ole eksitus.

Haldajatele mõeldud üksikasjad asuvad failis CLAUDE.md (range reegel nr 21) ja dokumendis RELEASE_CHECKLIST.md. See leht on avalik kaastöötajatele mõeldud kokkuvõte.

Lühidalt

Viide Roll
release/vX.Y.Z Aktiivne tsükkel — selle versiooni igapäevane arendus ja PR-ide mestimine
main Avaldatud versioonirida — saab tsükli squash-mestimise kaudu, kui versioon välja lastakse
vX.Y.Z (märgend) Väljalaskemärgis — muutumatu viit väljalaskmise hetkel avaldatud sisule 
flowchart LR
  A["feat/fix haru"] --> B["PR → release/vX.Y.Z"]
  B --> C["release/vX.Y.Z tipp"]
  C --> D["Väljalaske-PR mestitakse squash-meetodil → main"]
  D --> E["Märgend vX.Y.Z"]
  C --> F["Järgmine tsükkel: release/vX+1 luuakse külmutatud tipust"]
Loading

Millisele harule peaks mu PR olema suunatud?

Suunake PR aktiivsele harule release/vX.Y.Z, mitte harule main.

  1. Leidke suurima versiooniga avatud haru release/v* (näide kirjutamise ajal: release/v3.8.49).
  2. Looge oma haru selle tipust (git fetch + väljavõtmine / sellele rebase'imine).
  3. Avage PR, mille baasharu = vastav release/vX.Y.Z.

main ei ole igapäevane integratsiooniharu. Haru main vastu avatud PR-id tuleb tavaliselt enne mestimist ümber suunata.

Väljalaske külmutamine (paralleelsed tsüklid)

Väljalaske kooskõlastamise ajal avatakse märgendiga release-freeze tähistatud probleem. See ei peata arendust:

  • Külmutatud release/vX.Y.Z kuulub selle väljalaske eest vastutavale isikule.
  • Järgmise tsükli release/vX+1 luuakse külmutatud tipust, et kaastöötajad saaksid tööde lisamist jätkata.
  • Avatud PR-id, mis on endiselt suunatud külmutatud harule, tuleb ümber suunata aktiivsele (suurima versiooniga) harule release/v*.

Enne soovitud haru mestitavaks pidamist kontrollige, kas mõni külmutamine on aktiivne:

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

Mestimise mehhanism (omaniku märgend queue → Mergify) on dokumenteeritud failis MERGE_TRAIN.md.

Miks on vaja nii haru kui ka märgendit?

Artefakt Kestus Eesmärk
release/vX.Y.Z Pooleliolev tsükkel Kogub üle vaadatud PR-e, püsib CI-testides rohelisena ja on PR-ide baasharu
Märgend vX.Y.Z Igavesti Tähistab täpselt npm-i / GitHub Releasesi kaudu avaldatud sisu

Haru on töökoda, märgend aga suletud pakend. Pärast squash-mestimist harusse main jätkub järgmine tsükkel harus release/vX+1, ilma et peaks ootama eelmise väljalaske-PR-i lõpetamist.

Seotud dokumendid