Si funksionojnë etiketat dhe lëshimet në Git?

Question

Accepted Answer

**Etiketat** shënojnë pika specifike në historik si të rëndësishme — zakonisht **lëshimet** (versionet si v1.0.0). Ndryshe nga degët, etiketat janë tregues të fiksuar që nuk lëvizin, të përdorura për të etiketuar dhe referencuar versionet e lëshimit. Ato janë qendrore për versionimin dhe menaxhimin e lëshimeve.

## Krijimi i etiketave

```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 "..."
```

**Etiketat e shënuara** (të rekomanduara për lëshimet) ruajnë metadata (etiketuesit, datën, mesazhin); **etiketat e lehta** janë thjesht një emër që tregon në një commit.

## Puna me etiketat

```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
```

I rëndësishëm: **etiketat nuk shtypen automatikisht** me `git push` — ju i shtypni ato në mënyrë eksplicite.

## Etiketat vs degët

```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.
```

## Versionimi semantik dhe lëshimet

```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.
```

## Pse ka rëndësi

Kuptuarja e etiketave dhe lëshimeve është e vlefshme për **versionimin dhe menaxhimin e lëshimeve**, kështu që është njohuri praktike e dobishme për punën me softuearin e lëshuar. **Etiketat** shënojnë pika të rëndësishme në historik — zakonisht **versionet e lëshimit** (si v1.0.0) — duke ofruar referenca të fiksuara dhe permanente për commit specifike, që është thelbësore për gjurmimin dhe referencimin e kodit që përbën secilin lëshim.

Kuptuarja e dallimit midis **etiketave të shënuara** (të rekomanduara për lëshimet, duke ruajtur metadata si etiketuesit, datën dhe mesazhin) dhe etiketave të lehta është njohuri praktike për etiketimin e duhur të lëshimeve.

Dije se si të krijoni, listoni dhe kontrolloni etiketat, dhe në veçanti se **etiketat nuk shtypen automatikisht** (duke kërkuar `git push origin --tags` eksplicite ose shtyrjen e etiketave specifike — një problem i zakonshëm ku njerëzit krijojnë etiketat por harrrojnë t'i shtyjnë ato), është e nevojshme për të menaxhuar saktë etiketat e lëshimit.

Kuptuarja e **etiketave vs degëve** (një etiketë është një tregues i fikuar për një commit specifik — një etiketë permanente që nuk lëviz — ndërsa një degë është një tregues i lëvizshëm që përparon me zhvillimin) sqaron rolet e tyre të ndryshëm: etiketat për shënimin permanent të lëshimeve/pikave të rëndësishme, degët për punën në vazhdim.

Kuptuarja e lidhjes me **versionimin semantik** (konvencionet MAJOR.MINOR.PATCH për të komunikuar natyrën e ndryshimeve) dhe si platformat ndërtojnë **Lëshimet** nga etiketat (me shënime lëshimi dhe artefakte për shpërndarje) pasqyron se si etiketat përshtaten në menaxhimin e vërtetë të lëshimeve.

Meqenëse lëshimi dhe versionimi i softuerit është një nevojë e zakonshme dhe etiketat janë mekanizmi i Git për shënimin dhe referencimin e versioneve të lëshimit (qendrore për menaxhimin e lëshimeve dhe të integruar me shërbimet e lëshimit të platformave), kuptuarja e etiketave dhe lëshimeve — etiketat e shënuara vs etiketat e lehta, shtyrja e tyre, etiketat vs degët, dhe roli i tyre në versionimin/lëshimet — është njohuri e vlefshme dhe praktikisht e përshtatshme për Git për menaxhimin e softuerit të lëshuar, një aspekt i dobishëm i zhvillimit profesional i lidhur me konvencionet e versionimit dhe proceset e lëshimit.