وادار کردن خود به کامنت نوشتن
اندازه‌ی قلم متن
تخمین مدت زمان مطالعه‌ی مطلب: یک دقیقه


قابلیت جالبی در ویژوال استودیو وجود دارد که شاید کمتر در مورد آن مطلب نوشته شده است و آن هم تنظیم پروژه به نحوی است که اگر برای کلیه موارد public کامنتی نوشته نشود، برنامه کامپایل نخواهد شد. همچنین اگر نام پارامتری را تغییر دادید، اما کامنت مرتبط با آن را به روز نکردید، باز هم خطای کامپایل را دریافت خواهید کرد که از این لحاظ هم بسیار عالی است و به نوعی «وادار کردن خود به کامنت نوشتن» است.

برای این تنظیم، ابتدا به برگه خواص پروژه مراجعه کنید. سپس در قسمت Build تنظیمات زیر را اعمال نمائید:
Treat warnings as errors را بر روی All قرار دهید.
در ذیل آن، در قسمت Output‌، گزینه‌ی XML Documentation file را تیک بزنید.

البته این تغییر بهتر است در یک پروژه جدید مد نظر باشد، چون اگر الان اقدام به این تنظیم کنید، به طور قطع از خیر آن خواهید گذشت! کامنت نویسی به مرور و در حین توسعه یک برنامه یا کتابخانه قابل تحمل است وگرنه اگر برای روز آخر قرار داده شود، به احتمال زیاد انجام نخواهد شد.

مطالب مرتبط:



  • #
    ‫۱۲ سال و ۱۰ ماه قبل، یکشنبه ۱۸ دی ۱۳۹۰، ساعت ۲۳:۴۶
    سلام
    تو مطلب مربوط به لینک اول یعنی درست کردن فایل های راهنما ی CHM ، دانلود SDK مربوط به 
    Visual Studio 2008 SDK Version 1.0 حدودا 95 مگابایته. ولی برای 2010 حدودا 11 مگابایت. این دوتا با هم تفاوت دارند؟
  • #
    ‫۱۲ سال و ۱۰ ماه قبل، یکشنبه ۱۸ دی ۱۳۹۰، ساعت ۲۳:۵۷
    شما در کل نیازی به این SDK‌ ندارید، چون فرمت HTML help 2x چیزی نیست که به درد کاربر نهایی بخورد.
    فقط به برنامه HTML help workshop نیاز است جهت تولید CHM به علاوه برنامه sandcastle help file builder جهت اتوماسیون و سهولت کار.
  • #
    ‫۱۲ سال و ۱۰ ماه قبل، دوشنبه ۱۹ دی ۱۳۹۰، ساعت ۰۰:۳۰
    سلام، مطلبه جالبی بود.
    فقط یه سوال؟
    اگه از ابزارهایی مثل StyleCop استفاده کنیم (و تنظیمات مربوط به مستندسازی روز فعال کنیم) یه کم بهتر نیست؟
    تا حدودی هم انعطاف پذیرتره.
  • #
    ‫۱۲ سال و ۱۰ ماه قبل، دوشنبه ۱۹ دی ۱۳۹۰، ساعت ۰۰:۴۹
    بله؛ محترمانه‌تر هست! مثلا ReSharper هم محترمانه زیر این موارد خط می‌کشه (البته اگر تیک XML Documentation file خورده باشه).
    اگر نیاز به برخورد خشن‌تری (!) داشتید روش Treat warnings as errors یک نوع وادار کردن هست، آن هم غیرمحترمانه چون برنامه دیگر کامپایل نخواهد شد و ... کار به بعد موکول نمیشه.