Git میں tags اور releases کیسے کام کرتے ہیں؟

Question

Accepted Answer

**Tags** تاریخ میں اہم نقاط کو نشان زد کرتے ہیں — عام طور پر **releases** (ورژنز جیسے v1.0.0)۔ branches کے برعکس، tags fixed pointers ہیں جو حرکت نہیں کرتے، release versions کو label اور reference کرنے کے لیے استعمال ہوتے ہیں۔ یہ versioning اور release management کے لیے مرکزی ہیں۔

## Tags بنانا

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

**Annotated tags** (releases کے لیے سفارش شدہ) metadata محفوظ کرتے ہیں (tagger، تاریخ، پیغام)؛ **lightweight tags** صرف ایک commit کی طرف اشارہ کرنے والا نام ہے۔

## Tags کے ساتھ کام کرنا

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

اہم: **tags خودکار طور پر `git push` کے ساتھ push نہیں ہوتے** — آپ انہیں واضح طور پر push کرتے ہیں۔

## Tags بمقابلہ branches

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

## Semantic versioning اور releases

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

## یہ کیوں اہم ہے

Tags اور releases کو سمجھنا **versioning اور release management** کے لیے قیمتی ہے، اس لیے یہ released software کے ساتھ کام کرنے کے لیے مفید عملی علم ہے۔ **Tags** تاریخ میں اہم نقاط کو نشان زد کرتے ہیں — عام طور پر **release versions** (جیسے v1.0.0) — جو specific commits کے لیے fixed، permanent references فراہم کرتے ہیں، جو یہ track کرنے اور reference کرنے کے لیے ضروری ہے کہ ہر release میں کون سا code ہے۔

**Annotated tags** (releases کے لیے سفارش شدہ، tagger، تاریخ، اور پیغام جیسی metadata محفوظ کرتے ہوئے) اور lightweight tags کے درمیان فرق کو سمجھنا proper release tagging کے لیے عملی علم ہے۔

Tags بنانا، list کرنا، اور check out کرنا جاننا، اور اہم طور پر یہ کہ **tags خودکار طور پر push نہیں ہوتے** (explicit `git push origin --tags` یا specific tags push کرنے کی ضرورت ہے — ایک عام مسئلہ جہاں لوگ tags بناتے ہیں لیکن انہیں push کرنا بھول جاتے ہیں)، release tags کو صحیح طریقے سے منتظم کرنے کے لیے ضروری ہے۔

**Tags بمقابلہ branches** کو سمجھنا (ایک tag ایک specific commit کا fixed pointer ہے — ایک permanent label جو حرکت نہیں کرتا — جبکہ ایک branch ایک movable pointer ہے جو development کے ساتھ آگے بڑھتا ہے) ان کے مختلف کردار کو واضح کرتا ہے: tags releases/milestones کو permanently mark کرنے کے لیے، branches ongoing کام کے لیے۔

**Semantic versioning** (MAJOR.MINOR.PATCH conventions تبدیلیوں کی نوعیت بتانے کے لیے) سے connection کو سمجھنا اور یہ کہ platforms کیسے tags سے **Releases** بناتے ہیں (release notes اور distribution کے لیے artifacts کے ساتھ) یہ ظاہر کرتا ہے کہ tags real release management میں کیسے فٹ ہوتے ہیں۔

چونکہ software کو release کرنا اور versioning کرنا ایک عام ضرورت ہے اور tags release versions کو mark کرنے اور reference کرنے کا Git mechanism ہیں (release management کے لیے مرکزی اور platforms کی release features کے ساتھ integrated)، tags اور releases کو سمجھنا — annotated بمقابلہ lightweight tags، انہیں push کرنا، tags بمقابلہ branches، اور versioning/releases میں ان کا کردار — released software کو منتظم کرنے کے لیے قیمتی، عملی طور پر متعلقہ Git علم ہے، جو versioning conventions اور release processes سے منسلک professional development کا ایک مفید پہلو ہے۔