Branching & Merging

What You’ll Learn

• Branch কী এবং কেন দরকার
• Branch বানানো, switch করা, delete করা
• Branch naming convention (real company style)
• Merge করা — branch-এর কাজ main-এ আনা
• Merge conflict — কী হয়, কীভাবে fix করে
• git stash — কাজের মাঝে হঠাৎ switch করতে হলে

Branch কী? (Mental Model)

কল্পনা করো তুমি একটা বইয়ের writer। বইটা already published — সেটা হলো main branch।

এখন তুমি নতুন একটা chapter লিখতে চাও। কিন্তু সরাসরি published বই-এ লিখবে না, তাই না? তুমি একটা আলাদা draft খাতা নেবে, সেখানে লিখবে, edit করবে — যখন ready হবে তখন published বই-এ যোগ করবে।

Git-এ সেই আলাদা draft খাতাটাই হলো branch।

main branch (published, stable):
──●──●──●──●──────────────────────►
  A  B  C  D

তুমি D থেকে নতুন branch বানালে:
──●──●──●──●──────────────────────►  (main)
            \
             ●──●──●                 (feature/new-chapter)
             E  F  G

কাজ শেষে main-এ merge করলে:
──●──●──●──●──────────────────────●►  (main)
            \                    /
             ●──●──●────────────    (feature/new-chapter, merged)
             E  F  G

Part 1: Basic Commands

git branch feature/login-page

git switch feature/login-page

git switch -c feature/login-page

# Local branch দেখতে
git branch
 
# Local + Remote সব branch দেখতে
git branch -a

# Local branch delete (merge হয়ে গেলে)
git branch -d feature/login-page
 
# Force delete (merge না হলেও)
git branch -D feature/login-page

Part 2: Naming Convention

Real company-তে branch-এর নাম দেখলেই বোঝা যায় সে কী করছে। এটা একটা standard follow করে:

mybranch
test
new
fix1
asdf

feature/product-search
fix/login-redirect-bug
hotfix/checkout-500-error
docs/readme-update

Part 3: Branch Workflow

একটা real scenario দিয়ে দেখি। ধরো তুমি একটা website-এ কাজ করছ এবং নতুন “Contact Us” page বানাতে হবে।

git switch main
git pull

git switch -c feature/contact-page

touch contact.html
echo "<h1>Contact Us</h1>" > contact.html
 
git add contact.html
git commit -m "Add contact page with basic structure"

echo "<p>Email: hello@example.com</p>" >> contact.html
git add contact.html
git commit -m "Add email address to contact page"

git push -u origin feature/contact-page

Part 4: Merge

Branch-এর কাজ শেষ। এখন সেটা main-এ আনতে হবে।

# প্রথমে main-এ যাও
git switch main
 
# latest pull করো
git pull
 
# feature branch merge করো
git merge feature/contact-page

Output (smooth merge হলে):

Updating a1b2c3d..e4f5g6h
Fast-forward
 contact.html | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 contact.html

# Local branch delete
git branch -d feature/contact-page
 
# GitHub থেকেও delete করো
git push origin --delete feature/contact-page

Part 5: Merge Conflict

Conflict কখন হয়?

তুমি আর তোমার teammate একই file-এর একই line দুইজন দুইভাবে edit করলে Git বুঝতে পারে না কোনটা রাখবে। তখন সে তোমাকে জিজ্ঞেস করে — “তুমি ঠিক করো।“

Conflict দেখতে কেমন?

git merge feature/about-page

Output:

Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.

index.html file খুললে দেখবে:

<<<<<<< HEAD
<title>My Awesome Website</title>
=======
<title>My Portfolio Website</title>
>>>>>>> feature/about-page

Conflict Fix করো

তোমাকে decide করতে হবে কোনটা রাখবে। তিনটা option:

<title>My Awesome Website</title>

<title>My Portfolio Website</title>

<title>My Awesome Portfolio</title>

Fix করার পর <<<<<<<, =======, >>>>>>> lines গুলো সব মুছে দাও।

তারপর:

git add index.html
git commit -m "Merge feature/about-page: resolve title conflict"

Conflict এড়ানোর উপায়

• কাজ শুরুর আগে সবসময় git pull করো
• ছোট ছোট commits করো, বড় না
• একই file-এ দুইজন কাজ করলে আগে থেকে বলে রাখো

Part 6: git stash

কখন লাগে?

তুমি feature/login branch-এ কাজ করছ — অর্ধেক হয়েছে, commit করার মতো না। হঠাৎ boss বলল “main branch-এ একটা critical bug fix করো এখনই।”

তুমি কী করবে? Half-done কাজ commit করবে? সব delete করবে?

না — stash করবে। Stash হলো একটা temporary drawer — কাজ সেখানে রেখে দাও, পরে ফিরে এসে নাও।

# সব current changes stash করো
git stash

git switch main
# bug fix করো
git add .
git commit -m "Fix critical navigation bug"
git push

git switch feature/login
 
# stash থেকে কাজ ফিরিয়ে আনো
git stash pop

Stash Commands

git stash list                # একাধিক Stash দেখো
git stash apply stash@{1}     # Specific Stash Apply করো
git stash drop                # সবচেয়ে latest stash delete
git stash clear               # সব stash clear করো

Part 7: Team Scenario

এখন সব একসাথে দেখি। ধরো তুমি একটা team-এ কাজ করছ।

# ১. সকালে কাজ শুরু — latest নামাও
git switch main
git pull
 
# ২. নতুন feature-এর জন্য branch বানাও
git switch -c feature/search-bar
 
# ৩. কাজ করো
git add .
git commit -m "Add search bar UI to header"
 
git add .
git commit -m "Connect search bar to product API"
 
# ৪. কাজ শেষ — GitHub-এ push করো
git push -u origin feature/search-bar
 
# ৫. এখন Pull Request বানাবে GitHub-এ
# Teammate review করবে, approve করবে
# তারপর main-এ merge হবে
 
# ৬. Merge হওয়ার পর local cleanup
git switch main
git pull
git branch -d feature/search-bar

Checklist

• নতুন branch বানিয়ে switch করেছি (git switch -c)
• Branch-এ commit করেছি
• main-এ merge করেছি
• Merge conflict manually fix করেছি
• git stash দিয়ে কাজ save করে অন্য branch-এ গেছি
• Merge হওয়া branch delete করেছি

Common Problems & Fixes

git reset HEAD~1
git switch correct-branch
git add .
git commit -m "message"

git fetch --prune

What’s Next?

Branch এবং merge শেখা হয়ে গেছে। এখন শিখবে GitHub-এর সাথে properly কাজ করা — SSH, remote, Pull Request সব।