GitHub Essentials

What You’ll Learn

• Git আর GitHub-এর পার্থক্য (once and for all)
• git remote — local repo আর GitHub-এর connection
• git fetch vs git pull — পার্থক্য বোঝা
• GitHub UI-এর গুরুত্বপূর্ণ অংশগুলো
• Pull Request (PR) — বানানো, review করা, merge করা
• Issues — task এবং bug track করা
• Fork — অন্যের repo নিয়ে কাজ করা

Git vs GitHub — পার্থক্য কী?

এটা নিয়ে অনেক নতুনরা confused থাকে। একবারে clear করে নাও:

সহজ কথায়: Git হলো engine, GitHub হলো garage। তোমার গাড়ি (code) Git দিয়ে চলে, GitHub-এ রেখে দাও যাতে সবাই দেখতে পায়।

Part 1: git remote

Remote কী?

“Remote” মানে একটা দূরের repository-র address — সাধারণত GitHub-এ। তোমার local repo জানে কোথায় push করতে হবে, কোথা থেকে pull করতে হবে — এই information remote-এ থাকে।

git remote -v

origin  git@github.com:username/my-project.git (fetch)
origin  git@github.com:username/my-project.git (push)

git remote add origin git@github.com:username/my-project.git

# HTTPS থেকে SSH-এ switch করতে হলে
git remote set-url origin git@github.com:username/my-project.git

git remote remove origin

Part 2: fetch vs pull

এই দুইটা নিয়ে অনেকে confused হয়। পার্থক্যটা জানা দরকার।

git fetch — দেখো কিন্তু নামাও না

git fetch origin

এটা GitHub থেকে নতুন changes download করে কিন্তু তোমার files-এ apply করে না। তুমি আগে দেখতে পারবে কী কী এসেছে, তারপর decide করবে।

git pull — নামাও এবং apply করো

git pull

এটা আসলে দুইটা কাজ একসাথে করে:

1. git fetch — changes download করে
2. git merge — তোমার current branch-এ apply করে

কখন কোনটা?

Part 3: Pull Request

PR কী?

PR মানে “আমার branch-এর কাজ main-এ নিয়ে যাও” — এটা একটা formal request। Professional team-এ কেউ directly main-এ push করে না। সব কাজ PR-এর মাধ্যমে যায়।

git push -u origin feature/user-profile

Base: main          ←  কোথায় merge হবে
Compare: feature/user-profile  ←  কোনটা merge হবে

Title: Add user profile page

PR Review করা

তোমার teammate তোমাকে review করতে বলেছে। কী করবে?

1. Code দেখো: Files changed tab-এ যাও।
2. Comment করো: line number-এর পাশে ”+” click করো।
3. Review Submit করো: “Review changes” button-এ click করো এবং Approve বা Request changes দাও।

PR Merge করা

Approve হওয়ার পর merge করার ৩টা option:

Merge করার পর GitHub বলবে “branch delete করবে?” — Delete branch click করো।

Part 4: Issues

Issue হলো GitHub-এর task management system।

Issue থেকে Branch বানাও (best practice)

Issue page-এ right sidebar-এ “Create a branch” option আছে। এটা automatically branch বানায় issue number সহ: 1-login-button-not-working। এতে branch এবং issue automatically linked থাকে।

Commit-এ Issue Reference করো

git commit -m "Fix login button on Safari — closes #1"

closes #1 লিখলে PR merge হওয়ার সাথে সাথে Issue automatically close হয়ে যাবে।

Part 5: Fork

Fork কী?

Fork মানে অন্যের repository-র একটা copy তোমার GitHub account-এ নেওয়া।

git clone git@github.com:তোমার-username/repository-name.git
cd repository-name

git remote add upstream git@github.com:original-owner/repository-name.git

git switch -c fix/typo-in-readme
git add .
git commit -m "Fix typo in README"
git push origin fix/typo-in-readme

git fetch upstream
git switch main
git merge upstream/main
git push origin main

Checklist

• git remote -v দিয়ে remote দেখেছি
• git fetch এবং git pull এর পার্থক্য বুঝেছি
• GitHub-এ PR বানিয়েছি
• PR review করেছি এবং comment দিয়েছি
• Issue বানিয়েছি এবং commit-এ reference করেছি
• একটা repo fork করেছি এবং upstream add করেছি

Common Problems & Fixes

git switch feature/your-branch
git fetch origin
git merge origin/main
# conflict fix করো
git add .
git commit -m "Resolve merge conflicts with main"
git push

git fetch upstream
git switch main
git reset --hard upstream/main
git push origin main --force

What’s Next?

Git এবং GitHub-এর core সব শেখা হয়ে গেছে। এখন real-world scenarios শিখবে।