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 Overview

ব্রাঞ্চ কীভাবে কাজ করে তার একটি সহজ মানসিক ধারণা (Mental Model) বুঝে নাও।

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

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

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

নিচের ডায়াগ্রামটি খেয়াল করো:

• main branch: তোমার বইয়ের পাবলিশড অংশ (Commits A থেকে D).
• feature/new-chapter branch: নতুন চ্যাপ্টার লেখার ড্রাফট খাতা (Commits E, F, G).
• Merge: কাজ শেষে ড্রাফট অংশটি আবার main বইয়ের সাথে যুক্ত করা হয়েছে।

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

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

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

Merge Branches

এক ব্রাঞ্চের কাজ অন্য ব্রাঞ্চে (সাধারণত মেইন ব্রাঞ্চে) যুক্ত করার প্রক্রিয়া।

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

Merge Conflict

একই ফাইলে একাধিক পরিবর্তন এলে কীভাবে তা ম্যানুয়ালি ফিক্স করতে হয়।

Conflict Causes

কখন এবং কেন গিট মার্জ কনফ্লিক্ট তৈরি হয় সেটি বুঝে নাও।

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

Conflict Syntax

কনফ্লিক্ট লাগলে কোড ফাইলের ভেতরে যা পরিবর্তন আসে তা চিনে নাও।

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

Resolve Conflict

সহজ কিছু ধাপের মাধ্যমে মার্জ কনফ্লিক্ট সমাধান করার নিয়ম।

তোমাকে 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"

Prevent Conflicts

ভবিষ্যতে মার্জ কনফ্লিক্ট কমিয়ে আনার কিছু কার্যকরী টিপস।

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

Git Stash

অর্ধেক করা কাজগুলো সাময়িকভাবে জমা রাখা এবং পরে আবার শুরু করার উপায়।

Stash Scenarios

কখন তোমার গিট স্ট্যাশ কমান্ডটি ব্যবহার করা উচিত সেটি বুঝে নাও।

তুমি 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 Operations

স্ট্যাশে রাখা কাজগুলো দেখার এবং ম্যানেজ করার প্রয়োজনীয় কমান্ডসমূহ।

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

Team Workflow

একটি প্রোফেশনাল টিমে প্রতিদিন যেভাবে ব্রাঞ্চ ব্যবহার করে কাজ করা হয়।

এখন সব একসাথে দেখি। ধরো তুমি একটা 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

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 সব।