خلاصه فصل پنجم کتاب clean code

جوگیرساختن مخاطب برای خواندن تا ته

بعد از خوندن این فصل خیلی کوچیک، میفهمید فرمت کد تمیز و فاصله ها و فضای خالی چقدر باشه و چطوری باشه

فصل پنجم – Formatting

Vertical Formatting

فایل های با حجم کمتر قطعا خوندنشون راحتتره. توصیه میشه که هر فایل از کد در بهترین حالت بیشتر از ۵۰۰ خط نباشه. هرکه بامش بیش برفش بیشتر ( برف اینجا میزان نفهمیدنه )

The Newspaper Metaphor

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

روزنامه هم شامل متن های مختلفه که اونا کنار هم میتونن یه روزنامه رو تشکیل بدن. اگر کل روزنامه همش یه مطلب طولانی باشه دیگه کسی حال نداره بخونه .

Vertical Openness Between Concepts

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

Vertical Distance

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

Dependent Functions

وقتی ممد نزدیکت باشه صداش میکنی . توی کد هم وقتی تابعی داره یک تابع دیگه رو صدا میزنه باید نزدیک هم باشن.

Horizontal Formatting

یه فاصله شرعی و منطقی در عرض هم باید باشه که در این دور و زمونه خود ide انجام میده برامون.

Indentation

کد بدون ایندنت هم هرکی بزنه …

Team Rules

هرکه با یه استایل کدزنی حال میکنه ولی وقتی کار تیمی بشه همه تیم باید به یک صراطی مستقیم بشن تا کل کد یکپارچه بشه.