The longer it takes to write a comment for a piece of code, the worse the code probably is. This humorous observation highlights the importance of self-documenting code that is clear and concise.
هر چقدر نوشتن کامنت برای یک تکه کد زمان بیشتری ببرد، به احتمال زیاد آن کد کیفیت پایین‌تری دارد. این نکته‌ی طنزآمیز بر اهمیت کد خود-مستندنگاری که واضح و مختصر است، تأکید می‌کند.
کتاب Clean Code اثر "رابرت سی. مارتین" (Robert C. Martin) که در فارسی با عنوان "کد تمیز" شناخته می‌شود، نقشه راهی جامع برای نوشتن و بهبود کیفیت کد به شما ارائه می‌دهد. این کتاب به سه بخش اصلی تقسیم می‌شود:
۱. اصول، الگوها و تمرین‌های نوشتن کد تمیز:
بخش اول کتاب بر روی بنیان‌های نوشتن کد تمیز تمرکز می‌کند. در این بخش، اصول کلیدی، الگوهای مفید و تمرین‌های کاربردی برای خلق کد باکیفیت را فرا خواهید گرفت.
۲. مطالعات موردی با سطوح پیچیدگی افزایشی:
بخش دوم شامل چندین مطالعه‌ی موردی با درجات دشواری مختلف است. هر مطالعه، تمرینی برای پاکسازی و بهبود یک کد نمونه با مشکلات رایج به شمار می‌رود. با دنبال کردن این تمرین‌ها، گام به گام نحوه‌ی تبدیل کدهای نامناسب به نمونه‌هایی بهینه و کارآمد را یاد خواهید گرفت.
۳. درس‌آموخته‌ها و تشخیص مشکلات کد:
بخش سوم، دستاورد نهایی کتاب است. این بخش شامل فهرستی از قوانین سرانگشتی (heuristics) و بوهای بد کد (code smells) است که طی فرآیند مطالعه‌ی موردی جمع‌آوری شده‌اند. این دانش ارزشمند، طرز فکر و رویکرد مناسب هنگام نوشتن، خواندن و پاکسازی کد را برای شما ترسیم می‌کند.
با مطالعه‌ی این کتاب، مهارت‌های زیر را کسب خواهید کرد:
کتاب Clean Code برای تمامی توسعه‌دهندگان، مهندسان نرم‌افزار، مدیران پروژه، سرگروه‌های تیم و تحلیل‌گران سیستم که به تولید کد باکیفیت و حرفه‌ای اهمیت می‌دهند، منبعی ارزشمند و کاربردی به شمار می‌رود.
منبع
1 https://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882
2 https://redditfavorites.com/products/clean-code-a-handbook-of-agile-software-craftsmanship
