📘 BGCE Translation Guide (Simple & Clear Bangla Style)

This is how we’ll translate stuff for the BGCE book to make sure it's beginner-friendly, chill, and clear for Bengali devs. To ensure consistency, clarity, and accessibility, follow these guidelines while translating technical content to Bengali for the BGCE book:

Retain English for Key Technical Terms

• Always use English for programming keywords, tools, and common dev jargon.

• Examples:

  • ✅ code (❌ কোড)

  • ✅ closure (❌ ক্লোজার)

  • ✅ visualization (❌ ভিজ্যুয়ালাইজেশন)

⚠️ Use discretion — if the English term is very commonly used in Bengali dev circles, retain it.

Prefer Natural Language Over Literal Translation

• Avoid overly formal or uncommon Bengali words.

• Translate meaning, not word-for-word.

• Example:

  • ❌ "স্ট্যাক বনাম হিপ"

  • ✅ "Stack vs Heap" or "স্ট্যাক vs হিপ"

CLI and Code Blocks Must Stay in English

• Never translate code snippets, terminal commands, or code block outputs.

• Example:

  • ❌ git push → গিট পুশ

  • ✅ Leave git push as-is.

Don’t translate word-for-word, make it feel natural

• Say it the way you'd explain to a friend.

• Example:

  • English:

  "If a variable is used outside a function (like in a returned closure), it moves to the heap."

  • ✅ Good Bangla:

  “যদি কোনো ভেরিয়েবল ফাংশনের বাইরে ইউজ হয় (যেমন রিটার্ন করা কোনো ক্লোজার-এর ভিতরে), তখন সেটা হিপে চলে যায়।”

  • ❌ Bad Bangla:

  “যদি কোনো ভেরিয়েবল ফাংশনের বাইরে (যেমন একটি রিটার্ন হওয়া ক্লোজারে) ব্যবহৃত হয়, তবে সেটি হিপে স্থানান্তরিত হয়।”

Add extra words if needed cause clarity > literal

• Sometimes adding 2–3 extra words makes things way easier to understand. Do that.

• Example:

  • English: "Stack and Heap"

  • Bangla: “স্ট্যাক আর হিপ কীভাবে কাজ করে”

Small add-ons = big clarity

No bookish or rare Bengali words

• Don’t use words people don’t even hear in movies or the street.

• Instead, use how devs actually talk.

UI terms, buttons, tool names - keep original English

• Example:

  • ✅ "Click the Run button" → keep Run in English

Markdown formatting stays same

• Don’t break bullet points, code formatting, bold text, etc.

🎯 Goal: বাংলা হবে এমন, যেটা একজন নতুন ডেভেলপার পড়ে হাসে না বরং বুঝে। Simple, clear, and helpful. No extra drama.