কমেন্ট হলো আপনার কোডের মধ্যে থাকা এমন টেক্সট যা কম্পিউটার সম্পূর্ণভাবে উপেক্ষা করে — এটি মানুষের জন্য, মেশিনের জন্য নয়। কমেন্ট ব্যাখ্যা করে কোড *কেন* কিছু একটা করছে, বিশেষ করে যা কোড দেখেই স্পষ্ট বোঝা যায় না।
// এটি ট্যাক্সসহ মোট মূল্য হিসাব করে
let total = price * 1.18;/*
এই ফাংশনটি একজন ইউজারের বয়স যাচাই করে।
এটি true রিটার্ন করে শুধুমাত্র তখনই যখন বয়সটি একটি বাস্তবসম্মত মানুষের বয়স।
*/
function isValidAge(age) {
return age > 0 && age < 130;
}পরিষ্কার ভেরিয়েবল আর ফাংশনের নামযুক্ত ভালো কোডে খুব কম কমেন্টই দরকার হয় — কোড নিজেই নিজেকে ব্যাখ্যা করে। কমেন্ট লিখুন যখন *কেন*-টা স্পষ্ট নয়: কোনো বাগের সমাধান, কোনো অস্পষ্ট বিজনেস নিয়ম, অথবা সহজে ভেঙে যেতে পারে এমন কিছুর সতর্কবার্তা।
যে কমেন্ট শুধু কোডটাই আবার বলে দেয়, সেটা মূল্য যোগ করে না, শুধু বিশৃঙ্খলা তৈরি করে: x = x + 1;-এর উপরে // add 1 to x লিখলে আপনি এমন কিছু জানতে পারবেন না যা আগে থেকেই দেখতে পাচ্ছিলেন না।