یکی از کارهایی که به مراد یادگرفتن html و یا این که با انگیزه مستندسازی ( documentaion ) خوبتر پوشه های اچ تی ام ال انجام می شود , به کار گیری از توضیحات ( html comments ) است . توضیحات در html , این قابلیت و امکان را می دهند که بین کدهای html , به مرورگر اعلام فرمایید که جزء کد را نظیر سایر به طور کدهای معمولی html , تعبیروتفسیر نکنند .
برای درج توضیحات , نوشته توضیح متبوع را میان جفت تگ های پایین می‌آوریم :
1
برای مثال , خوا هیم داشت :
1
. ir – - >
نکته :
این یک نادرست مرسوم است که گفته می شود :
مرورگرها وقتی که با توضیحات مواجه میشوند , از تعبیروتفسیر آن نصیب صرفنظر می نمایند .
بلکه حقیقت این است که مرورگرها توضیحات را تعبیروتفسیر می نمایند , ولی خیر به طور موادسازنده معمولی اچ تی ام ال , بلکه با قواعد و ضوابط منحصر به خودش .
فواید استعمال از توضیحات در کدهای html
توضیحات به شما یاری می نمایند تا هرگاه در آتی به کدهای خویش مراجعه میکنید , بتوانید متوجه شرح وظیفه‌های هر بخش بشوید .
همینطور در شرایطی‌که که همکارانتان بخواهند کدهای شما‌را دستکاری نمایند , وجود توضیحات یاری خیلی خیر به آنان می نماید تا بتوانند سریعتر به اجزای متفاوت کدهای html پی ببرند و بتوانند تغییری که مورد علاقه دارا‌هستند را خوبتر اعمال نمایند قالب وردپرس .
گهگاه به کارگیری از توضیحات در html به مراد مشخص و معلوم کردن تگ های پایان است . این عمل در ساخت وب سایت امداد متعددی به طراح می نماید ; به دلیل آنکه سبب می شود وجود تگ های داخلی , طراح تارنما را به خطا نیندازد .
همینطور به کار گیری از توضیحات گهگاه به دلیل ایرادیابی موادسازنده html یک ورقه ی اینترنت است . برای این خواسته بخش های گوناگون را به موقعیت توضیحات در می‌آوریم تا مرورگرها از تعبیر و تفسیر آن‌ها به طور عنصرها معمولی , صرفنظر نمایند . آن‌گاه برای موادسازنده متفاوت این عمل را انجام می‌دهیم و سود را در مرورگر دنبال میکنیم تا متوجه بشویم که کدام یک از موادتشکیل دهنده منجر پیدایش انواع در صفحه های وب سایت پباده سازی شده , گردیده اند .
نمونه های ذیل هر مورد از فواید استعمال از توضیحات در کدهای html را بررسی میکنیم :
در کد ذیل شرح وظیفه‌های عنصر ذی‌ربط با توضیحات مشخص و معلوم شده‌است