ডেভেলপারের মতো ডকুমেন্টেশন পড়া ও debug করা

যারা কয়েক দিন আটকে থাকে আর যারা এগিয়ে চলে তাদের আলাদা করে দুটি দক্ষতা: ডকুমেন্টেশন পড়া ও debugging। দুটিই পদ্ধতি হিসেবে শেখা যায়।

অংশ ১: ডকুমেন্টেশন পড়া

ডকুমেন্টেশন প্রথমে ভয়ংকর লাগে কারণ এটি গল্প নয়, রেফারেন্স হিসেবে লেখা। এটিকে মানচিত্রের মতো ব্যবহার করুন।

ডকুমেন্টেশনের ধরন জানুন

• Getting started / tutorial: পথ দেখানো নির্দেশিকা। নতুন টুলে আগে পড়ুন।
• Guide / concept: কীভাবে ও কেন কাজ করে ব্যাখ্যা করে।
• API reference: প্রতিটি function, option ও parameter। এখানে খুঁজুন, শুরু থেকে শেষ পড়বেন না।
• উদাহরণ ও recipe: মানিয়ে নেওয়ার মতো কোড।
• Changelog ও migration guide: সংস্করণের মধ্যে কী বদলেছে।

দ্রুত পদ্ধতি

১. সংস্করণ দেখুন। সংস্করণ ৩-এর ডকুমেন্টেশন আপনার ৫ সংস্করণের সাথে নাও মিলতে পারে। সংস্করণ নির্বাচক ব্যবহার করুন। ২. শব্দভাণ্ডার জানতে overview ও getting started পড়ুন। ৩. নিজে সবচেয়ে ছোট উদাহরণ চালান। একটি জিনিস বদলে কী হয় দেখুন। ৪. যা দরকার সেখানে যেতে search বক্স ও browser-এর find ব্যবহার করুন। ৫. Function-এর জন্য তার signature, parameter, ফেরত মান ও উদাহরণ পড়ুন এবং কী error দিতে পারে লক্ষ্য করুন। ৬. আরও দরকার হলে প্রজেক্টের source code, test বা issue দেখুন। Test দারুণ কাজের উদাহরণ। ৭. যা আবার লাগবে তার ছোট নোট রাখুন।

বিশ্বাস করুন কিন্তু যাচাই করুন

ব্লগ পোস্ট, ভিডিও ও AI উত্তর ভুল বা পুরোনো হতে পারে। আচরণের চূড়ান্ত সত্য হলো অফিশিয়াল ডকুমেন্টেশন ও প্রজেক্টের source। নিশ্চিত করতে কোড চালিয়ে দেখুন।

অংশ ২: debugging

Bug হলো আপনি যা আশা করেন আর যা ঘটে তার ফাঁক। Debugging হলো আন্দাজ নয়, প্রমাণ দিয়ে সেই ফাঁক বন্ধ করা।

পদ্ধতি

১. পুনরুৎপাদন করুন। প্রতিবার bug ঘটায় এমন সঠিক ধাপ খুঁজুন। পুনরুৎপাদন না করতে পারলে কখন ঠিক হয়েছে জানা যায় না। ২. Error মনোযোগ দিয়ে পড়ুন। বার্তা ও stack trace দিয়ে শুরু করুন। আপনার নিজের কোডের প্রথম লাইনই সাধারণত দেখার জায়গা। হুবহু error লেখা সার্চ করুন। ৩. অনুমান (hypothesis) করুন। "মনে হচ্ছে এটি চলার সময় list ফাঁকা।" ৪. Print, log, debugger breakpoint বা ছোট test দিয়ে অনুমান পরীক্ষা করুন। ধারণা নয়, আসল মান দেখুন। ৫. সংকীর্ণ করুন। কোড comment out করুন, ন্যূনতম উদাহরণ নিন, বা binary search করুন: ধারার মাঝখানে দেখুন data সেখানেই ভুল কি না। ৬. একবারে একটি জিনিস বদলান এবং আবার চালান। ৭. লক্ষণ নয়, কারণ ঠিক করুন। তারপর একটি test যোগ করুন যাতে নীরবে ফিরতে না পারে।

কাজের টুল

• স্পষ্ট লেবেলসহ print/log বিবৃতি। সরল ও কার্যকর।
• Debugger: প্রোগ্রাম থামান, লাইন ধরে ধরে এগোন, variable দেখুন।
• Browser DevTools: frontend bug-এর জন্য console, network ট্যাব ও breakpoint।
• Version control: git diff ও git bisect bug কখন এসেছে খুঁজতে সাহায্য করে।
• Production bug-এর জন্য log ও monitoring।

দেখার সাধারণ কারণ

• বানান ভুল, ভুল variable, ভুল ফাইল বা ভুল পরিবেশ।
• Loop-এ off-by-one ভুল।
• আশা না করা null, undefined বা ফাঁকা মান।
• আপনার ভাবা ধরন নয় (লেখা হিসেবে সংখ্যা)।
• Asynchronous সময়: আসার আগেই মান ব্যবহার।
• বাসি cache, পুরোনো build বা যে কোড সম্পাদনা করেছেন সেটি চলমান কোড নয়।
• আপনার মেশিন ও server-এর মধ্যে configuration ও পরিবেশের পার্থক্য।

মানসিকতা

• শান্ত থাকুন। কম্পিউটার ঠিক তাই করছে যা আপনি বলেছেন, আপনি যা বোঝাতে চেয়েছেন তা না হলেও।
• Rubber duck বা বন্ধুকে জোরে সমস্যা ব্যাখ্যা করুন। প্রায়ই মাঝপথেই খুঁজে পান।
• বিরতি নিন। তাজা চোখ দ্রুত খুঁজে পায়।
• ধরে নিন bug আগে আপনার কোডে, framework বা compiler-এ নয়।

অংশ ৩: ভালো প্রশ্ন করা

সাহায্য দরকার হলে উত্তর দেওয়া সহজ করুন:

১. আপনি কী অর্জন করতে চান। ২. আপনি কী চেষ্টা করেছেন ও কী ঘটেছে। ৩. টেক্সট হিসেবে কপি করা হুবহু error বার্তা। ৪. সমস্যা দেখায় এমন ন্যূনতম কোড উদাহরণ। ৫. আপনার সংস্করণ ও পরিবেশ।

Public প্রশ্নে কখনো secret, key বা ব্যক্তিগত data দেবেন না।

AI সহায়ক ভালোভাবে ব্যবহার

AI error ব্যাখ্যা, ডকুমেন্টেশনের সারাংশ ও সমাধান প্রস্তাব করতে পারে। ডেভেলপার হিসেবে বাড়তে থাকতে:

• আগে নিজে চেষ্টা করুন, তারপর জিজ্ঞেস করুন, যাতে নিজের দক্ষতা গড়ে।
• AI-কে পূর্ণ error ও প্রাসঙ্গিক কোড দিন।
• শুধু সমাধান নয়, কেন জিজ্ঞেস করুন এবং বুঝেছেন নিশ্চিত করুন।
• অফিশিয়াল ডকুমেন্টেশনের সাথে এবং কোড চালিয়ে যাচাই করুন, কারণ উত্তর আত্মবিশ্বাসী ও ভুল হতে পারে।
• যাচাই না করা টুলে secret বা ব্যক্তিগত কোড পেস্ট করবেন না।

মূল কথা: সংস্করণ দেখে ডকুমেন্টেশন পড়ুন, ছোট দিয়ে শুরু করুন এবং খোঁজার জন্য reference ব্যবহার করুন। Debug করুন পুনরুৎপাদন, অনুমান, প্রমাণ দিয়ে পরীক্ষা ও কারণ ঠিক করে, তারপর test যোগ করুন। হুবহু error ও ন্যূনতম উদাহরণসহ পরিষ্কার প্রশ্ন করুন।

---

প্রোগ্রামিং রোডম্যাপ সিরিজ, পর্ব ১ (শুরু করা): 5 নম্বর (মোট 5)। আগের লেখা: Frontend developer রোডম্যাপ: HTML, CSS, JavaScript ও তার পর.