اگر آپ نے کوڈیکس (Codex) سے کوئی مفید چیز بنائی ہے اور اسے صرف اپنے laptop تک محدود رکھ دیا ہے تو آپ نے آدھا کام کیا ہے۔ GitHub وہ جگہ ہے جہاں آپ کا پروجیکٹ محفوظ بھی ہوتا ہے، share بھی ہوتا ہے، اور future changes بھی track ہوتے ہیں۔
گٹ ہب کو سادہ لفظوں میں کیسے سمجھیں؟
گٹ ہب کو یوں سمجھیں:
- گوگل ڈرائیو جیسی online جگہ
- لیکن خاص طور پر code اور پروجیکٹس کے لیے
یہاں آپ:
- پروجیکٹ save کرتے ہیں
- updates track کرتے ہیں
- دوسروں کو link دیتے ہیں
- لائیو deployment کے لیے پروجیکٹ connect کرتے ہیں
کوڈیکس users کے لیے GitHub کیوں ضروری ہے؟
کوڈیکس سے کام تیزی سے بنتا ہے، لیکن یہی speed ایک risk بھی بن سکتی ہے۔ اگر آپ changes save نہ کریں تو:
- پروجیکٹ گم ہو سکتا ہے
- اچھا version overwrite ہو سکتا ہے
- لائیو کرنے میں مشکل ہو سکتی ہے
گٹ ہب ان سب مسائل کا حل ہے۔
چار بنیادی الفاظ
موضوع: Repository
یہ آپ کے پروجیکٹ کا online folder ہے۔
موضوع: Commit
یہ save point ہے۔ یعنی آپ نے ایک meaningful تبدیلی محفوظ کر دی۔
موضوع: Push
اپنے computer یا local پروجیکٹ سے GitHub پر upload کرنا۔
موضوع: Branch
پروجیکٹ کی الگ working کاپی جہاں آپ experiment کر سکتے ہیں۔
ابتدائی صارفین کے لیے شروع میں repository، commit اور push سمجھنا کافی ہے۔
پروجیکٹ upload کرنے سے پہلے کیا check کریں؟
گٹ ہب پر upload سے پہلے یہ ضرور دیکھیں:
- page یا ایپ چل رہی ہے؟
- غیر ضروری فائلز تو نہیں؟
- پروجیکٹ folder واضح ہے؟
- ریڈ می یا short note موجود ہے؟
یعنی پہلے پروجیکٹ کو tidy کریں، پھر upload کریں۔
کوڈیکس اس مرحلے میں کہاں مدد دیتا ہے؟
کوڈیکس سے آپ یہ کام کرا سکتے ہیں:
- پروجیکٹ فائلز جائزہ
- غیر ضروری فائلز کی نشاندہی
- ریڈ می draft
- commit message ideas
- next steps explanation
مثلاً:
میرے پروجیکٹ folder کو دیکھو اور بتاؤ GitHub پر upload سے پہلے کون سی فائلز ready ہیں اور کون سی غیر ضروری ہیں۔
یا:
میرے پروجیکٹ کے لیے ایک آسان README لکھ دو۔
گٹ ہب ورک فلو ابتدائی صارفین کے لیے
مرحلہ 1: GitHub account بنائیں
اگر account نہیں ہے تو github.com پر مفت account بنائیں۔
مرحلہ 2: نئی repository بنائیں
ایک new repository بنائیں، مثلاً:
- codex-first-page
- urdu-ai-codex-demo
- والدین-ai-landing-page
مرحلہ 3: پروجیکٹ connect کریں
اپنی local فائلز یا پروجیکٹ folder کو GitHub repository کے ساتھ جوڑیں۔
مرحلہ 4: پہلا commit کریں
نوٹ: واضح message لکھیں:
- first لینڈنگ پیج
- initial کوڈیکس پروجیکٹ
- اردو workshop page draft
مرحلہ 5: push کریں
اب پروجیکٹ GitHub پر چلا جائے گا۔
اچھا commit message کیسا ہوتا ہے؟
کمزور:
- update
- changes
- آخری
بہتر:
- add first Urdu لینڈنگ پیج
- add course registration section
- fix mobile spacing and CTA
نوٹ: واضح message future میں بہت مدد دیتا ہے۔
ریڈ می کیوں ضروری ہے؟
ریڈ می وہ پہلی چیز ہے جو کوئی بھی GitHub پر دیکھتا ہے۔ اس میں کم از کم یہ ہونا چاہیے:
- پروجیکٹ کیا ہے
- کس مقصد کے لیے ہے
- کون سی technology یا tool استعمال ہوا
- لائیو لنک اگر موجود ہو
کوڈیکس سے یہ فوراً لکھوایا جا سکتا ہے۔
ابتدائی صارفین کے لیے ایک مفید کوڈیکس پرامپٹ
میرے موجودہ پروجیکٹ کو GitHub-ready بناؤ۔ پہلے فائلز جائزہ کرو، پھر ایک آسان README draft دو، پھر مجھے واضح بتاؤ کہ first commit کے لیے کیا message مناسب ہوگا۔
عام غلطیاں
1. ہر چیز upload کر دینا
نوٹ: temporary فائلز، random screenshots یا غیر ضروری folders upload نہ کریں۔
موضوع: 2. پروجیکٹ چیک کیے بغیر push کر دینا
پہلے verify کریں کہ current version واقعی وہی ہے جو آپ share کرنا چاہتے ہیں۔
موضوع: 3. vague commit messages
بعد میں خود کو بھی سمجھ نہیں آئے گا کیا بدلا تھا۔
موضوع: 4. README نہ بنانا
یہ small چیز لگتی ہے، لیکن portfolio value اسی سے بڑھتی ہے۔
گٹ ہب link کا فائدہ کیا ہے؟
ایک اچھا GitHub link آپ کو یہ سب دیتا ہے:
- proof کہ پروجیکٹ واقعی بنایا گیا
- کلائنٹ یا طالب علم کے ساتھ sharing
- future updates کا record
- کلاوڈ فلیئر یا دوسری hosting سے connection
یعنی GitHub صرف storage نہیں، publishing pipeline کا حصہ ہے۔
اگلا قدم
گٹ ہب پر پروجیکٹ چڑھ گیا تو اب اصل مزہ شروع ہوتا ہے: اسے live کرنا۔
یعنی اب لوگ صرف code نہیں دیکھیں گے بلکہ actual ویب سائٹ کھول سکیں گے۔
اگلی گائیڈ میں
اب پروجیکٹ GitHub پر محفوظ ہے۔ اگلی گائیڈ: کوڈیکس سے Cloudflare پر ویب سائٹ live کرنا میں ہم سیکھیں گے کہ GitHub repository کو Cloudflare Pages سے جوڑ کر public link کیسے حاصل کیا جاتا ہے۔
