Commit اور Push

ایک بار Diff review کر لینے اور AI agent کی تبدیلیوں سے مطمئن ہونے کے بعد، وقت آ گیا ہے Commit اور Push کرنے کا۔ یہ گائیڈ staging سے آپ کے remote repository پر pushing تک پورا workflow walkthrough کرتا ہے۔

تبدیلیاں Stage کریں

Staging آپ کو یہ منتخب کرنے دیتا ہے کہ بالکل کون سی تبدیلیاں اس Commit میں جائیں۔ مثال کے طور پر آپ feature code کو config تبدیلی سے الگ Commit کرنا چاہ سکتے ہیں۔

Git پینل میں، ہر modified فائل Unstaged Changes section میں ظاہر ہوتی ہے:

• فائل کو individually stage کرنے کے لیے اس کے ساتھ checkbox check کریں
• ایک ساتھ ہر تبدیل شدہ فائل stage کرنے کے لیے Stage All کلک کریں
• فائل unstage کرنے کے لیے، اسے uncheck کریں — یہ واپس Unstaged میں چلی جاتی ہے

Staged files sidebar کے اوپر Staged Changes section میں آ جاتی ہیں۔ صرف staged files Commit میں شامل ہوں گی۔

آپ پوری فائل کی بجائے individual hunks (فائل کے sections) بھی stage کر سکتے ہیں۔ Diff view میں، hunk پر hover کریں اور ظاہر ہونے والا + بٹن کلک کریں صرف وہ section stage کرنے کے لیے۔ یہ مفید ہے جب فائل میں دو غیر متعلق تبدیلیاں ہوں اور آپ ابھی صرف ایک Commit کرنا چاہتے ہوں۔

Commit Message لکھیں

Files staged ہونے کے بعد، Git پینل کے نیچے text فیلڈ میں اپنا Commit message ٹائپ کریں۔

ایک اچھا Commit message آپ کی history پڑھنے کے قابل بناتا ہے — آپ کے future self کے لیے اور project پر کسی اور کے لیے۔ کچھ ٹپس:

• imperative tense استعمال کریں — "Add login form" لکھیں نہ کہ "Added login form" یا "Adding login form"
• کیا بدلا اور کیوں بیان کریں — "Fix null check in user.ts" "fix bug" سے زیادہ مفید ہے
• پہلی لائن 72 characters سے کم رکھیں — زیادہ تر git ٹولز list views میں لمبے messages truncate کرتے ہیں
• اگر ضرورت ہو تو body شامل کریں — پہلی لائن کے بعد دو بار Enter دبائیں نیچے لمبی وضاحت شامل کرنے کے لیے

واضح Commit messages کی مثالیں:

• Add email validation to signup form
• Fix crash when user list is empty
• Update API base URL for production

Commit کریں

message فیلڈ کے نیچے Commit بٹن کلک کریں۔ staged تبدیلیاں آپ کی local git history میں ایک نئے Commit کے طور پر محفوظ ہو جاتی ہیں، اور staged files section صاف ہو جاتا ہے۔

Commit اب آپ کی branch history میں ظاہر ہوتا ہے۔ اگر آپ کو اسے undo کرنا ہو، تو history view میں Commit پر right-click کریں اور Undo Commit منتخب کریں — یہ تبدیلیوں کو واپس آپ کی unstaged files میں رکھ دیتا ہے انہیں کھوئے بغیر۔

Remote پر Push کریں

Committing تبدیلیاں locally محفوظ کرتا ہے۔ انہیں GitHub، GitLab، یا اپنے دوسرے remote پر بھیجنے کے لیے:

1. Git پینل toolbar میں Push بٹن کلک کریں (اوپر-تیر آئیکن)
2. اگر branch پہلے سے remote پر موجود ہے، تو آپ کے Commits فوری Push ہو جاتے ہیں
3. اگر یہ نئی branch ہے جو ابھی remote پر موجود نہیں، تو Publish Branch کلک کریں — یہ remote پر branch بناتا ہے اور آپ کے Commits Push کرتا ہے

اگر credentials مانگی جائیں، تو آپ انہیں enter کر سکتے ہیں یا SSH key authentication پر switch کر سکتے ہیں۔ اپنا GitHub account connect کرنے کے لیے Git Accounts دیکھیں تاکہ credentials خودکار طریقے سے handle ہوں۔

تبدیلیاں Pull کریں

remote سے تبدیلیاں لانے کے لیے (مثال کے طور پر اگر کسی teammate نے Push کیا ہو):

1. toolbar میں Pull بٹن (نیچے-تیر آئیکن) کلک کریں
2. Remote تبدیلیاں fetch ہو کر آپ کی local branch میں merge ہو جاتی ہیں

اگر merge conflicts ہوں، تو Git پینل conflicting files highlight کرتا ہے۔ conflict resolve کرنے کے لیے ہر ایک کھولیں، پھر resolution stage کریں اور Commit کریں۔

Push کرنے کے بعد، آپ کی تبدیلیاں remote پر ہیں اور آپ کی team کے لیے دستیاب ہیں یا pull request کے لیے تیار ہیں۔ Git پینل دکھاتا ہے کہ آپ کی branch remote کے ساتھ up to date ہے۔