Kaip Git sistemoje veikia žymos ir leidimai?

Question

Accepted Answer

**Žymos** žymi svarbius taškus istorijoje — paprastai **leidimai** (versijos pvz. v1.0.0). Skirtingai nuo šakų, žymos yra fiksuoti rodikliai, kurie nejuda ir naudojami leidimo versijoms žymėti ir nuorodoms kurti. Jos yra centrinės versijų ir leidimų valdymo dalis.

## Žymų kūrimas

```bash
# annotated tag (recommended for releases — has metadata: tagger, date, message)
git tag -a v1.0.0 -m "Release version 1.0.0"

# lightweight tag (just a pointer, no metadata)
git tag v1.0.0

# tag a specific past commit
git tag -a v1.0.0 <commit> -m "..."
```

**Anotacijos žymos** (rekomenduojamos leidimams) saugo metaduomenis (žymėtoją, datą, žinutę); **lengvos žymos** — tik vardą, nurodantį užkodį.

## Darbas su žymomis

```bash
git tag                        # list tags
git show v1.0.0                # show a tag and its commit
git checkout v1.0.0            # check out the code at a tag (detached HEAD)

# tags are NOT pushed by default — push them explicitly:
git push origin v1.0.0         # push a specific tag
git push origin --tags         # push all tags
```

Svarbu: **žymos nėra automatiškai nusiunčiamos** su `git push` — jas turite nusumesti aiškiai.

## Žymos ir šakos

```text
BRANCH → a MOVABLE pointer that advances as you commit (ongoing development)
TAG    → a FIXED pointer to a specific commit (a permanent label — doesn't move)
→ Use tags to permanently mark releases/milestones; branches for ongoing work.
```

## Semantinis versijimas ir leidimai

```text
SEMANTIC VERSIONING (SemVer): MAJOR.MINOR.PATCH (e.g. v2.3.1)
  MAJOR → breaking changes | MINOR → new features (compatible) | PATCH → bug fixes
→ Tags label these versions. Platforms (GitHub) build "Releases" from tags
  (with release notes, built artifacts) for distribution.
```

## Kodėl tai svarbu

Supratimas apie žymas ir leidimai yra vertingas **versijimui ir leidimų valdymui**, todėl tai naudinga praktinė žinios darbui su išleista programine įranga. **Žymos** žymi svarbius taškus istorijoje — paprastai **leidimo versijas** (pavyzdžiui v1.0.0) — suteikdamos fiksuotas, nuolatines nuorodas į konkrečius užkodus, kurie yra esminiai siekiant sekti ir nurodyti, koks kodas sudaro kiekvieną leidimą.

Supratimas apie skirtumą tarp **anotacijos žymų** (rekomenduojama leidimams, saugančios metaduomenis, tokius kaip žymėtojas, data ir žinutė) ir lengvų žymų yra praktinė žinios tinkamam leidimų žymėjimui.

Žinojimas, kaip kurti, išvardyti ir prisijungti prie žymų, ir svarbiausia, kad **žymos nėra nusiunčiamos automatiškai** (reikalauja aiškaus `git push origin --tags` arba konkrečių žymų nusiunčiamo — dažna klaida, kai žmonės kuria žymas, bet pamiršta jas nusumesti), yra būtinas tinkamam leidimų žymų valdymui.

Supratimas apie **žymas ir šakas** (žyma yra fiksuotas rodiklis į konkretų užkodą — nuolatinis žymėjimas, kuris nejuda — o šaka yra judrus rodiklis, kuris eina su plėtra) aiškina jų skirtingus vaidmenis: žymos nuolatiniam leidimų/dalykų žymėjimui, šakos tęsiamam darbui.

Supratimas apie ryšį su **semantiniu versijumu** (MAJOR.MINOR.PATCH susitarimais, skirtais komunikuoti pokyčio pobūdžiui) ir kaip platformos kuria **Leidimai** iš žymų (su leidimų pastabomis ir artefaktais paskirstymui) atspindi, kaip žymos telpa į tikrą leidimų valdymą.

Kadangi programinės įrangos leidimas ir versijimas yra dažnas poreikis, o žymos yra Git mechanizmas leidimų versijoms žymėti ir nuorodoms kurti (centrinės leidimų valdymui ir integruotos su platformų leidimų funkcijomis), supratimas apie žymas ir leidimai — anotacijos ir lengvas žymas, jų nusiuntimą, žymas ir šakas, bei jų vaidmenį versijime/leidimams — yra vertinga, praktiškai aktuali Git žinios leidimų valdymui, naudingas profesionalaus kūrimo aspektas, susijęs su versijimo susitarimais ir leidimų procesais.