توضیح (برنامه‌نویسی رایانه‌ای)

توضیح یا کامِنت   متنی جهت گزارمان در کد منبع است که اجرا نمی‌شود. توضیح‌ها متن‌های جهت افزایش خوانایی کد منبع هستند که توسط مفسرها و کامپایلرها اجرا نمی‌شوند.

تعریف 
متن‌هایی هستند که برنامه نویسان در میان کدها می‌نویسند، اما آن متن‌ها به همراه کد اجرا نخواهند شد و تنها در میان کدها دیده می‌شوند و در خروجی برنامه نیز هیچ اثری از آنها نیست. هدف از استفاده از توضیحات، بالابردن خوانایی و تشخیص نقش کدهای نوشته شده توسط برنامه‌نویس، برای دیگران است.

کاربرد 
هنگامی کد منبع از چندین خط تشکیل شده باشد یا اینکه زمان زیادی از کدنویسی آن پروژه گذشته باشد، خود به خود برنامه‌نویس ساختار کدنویسی خود را فراموش می‌کند. در این شرایط، اگر برنامه‌نویس، توضیحاتی در مورد ساختار و عملکرد کدها نوشته باشد، تنها با خواندن آن توضیحات، می‌تواند دوباره ساختار را به راحتی درک کند یا همچنین زمانی که برنامه‌نویس قصد دارد کدهای خود را در اختیار یک برنامه‌نویس دیگر قرار دهد، با نوشتن توضیحات در کدهایش، درک کدها را برای برنامه‌نویس دیگر بسیار ساده‌تر می‌کند.

انواع 
در زبان‌های سی، سی++، جاوا، سی شارپ و جاوااسکریپت توضیحات را می‌توانیم به دو صورت تک خطی و چند خطی بنویسیم.
 توضیحات تک خطی (Inline comments): می‌توان توضیحاتی در یک خط نوشت.

 توضیحات چندخطی (Block comments): می‌توان توضیحاتی در چند خط نوشت.

مثال 
برای مثال کد منبع زبان جاوااسکریپت در زیر، از دو نوع توضیحات استفاده کرده‌است:/*
پروژه
اول من
*/
document.write("Hello, World!"); // در خروجی متن داخل دابل کوتیشن چاپ می‌شود

جستارهای وابسته 
 حساسیت موردی
 برنامه‌نویسی ادیبانه

منابع 

فراداده
کد منبع