بتل کد Battle Codeدارد باز می‌شود…

اصطلاح‌های بامزه

برنامه‌نویس‌ها شوخ‌طبع‌اند و برای دردهای مشترکشان اسم‌های عجیب ساخته‌اند: اردک، یاک، انبارک دوچرخه. هر کدام یک داستان دارد.

اصطلاح را کلمه‌به‌کلمه ترجمه نکن

معنای یک اصطلاح از جمع معنای کلمه‌هایش درنمی‌آید: در yak shaving نه یاکی هست و نه تیغی. بیشترشان هم با یک قالب ثابت می‌آیند. reinvent the wheel و silver bullet تقریباً همیشه منفی‌اند: Don't reinvent the wheel و There is no silver bullet. bikeshedding و yak shaving هم با ‎-ing مثل اسمِ یک کار به کار می‌روند.

هشت کلمه‌ی این درس

rubber duck (رابِر داک): اردک پلاستیکی؛ توضیح دادن کد برای یافتن باگ

rubber یعنی لاستیک و duck یعنی اردک: همان اردک زرد حمام. در کتاب The Pragmatic Programmer از برنامه‌نویسی می‌گویند که یک اردک پلاستیکی روی میزش داشت و هر وقت گیر می‌کرد، کدش را خط‌به‌خط برای آن توضیح می‌داد. اردک جوابی نمی‌دهد، ولی وسط توضیح دادن، خودت می‌بینی کجا اشتباه کرده‌ای. به این کار می‌گویند rubber duck debugging.

I explained the bug to my rubber duck and found it myself.

باگ را برای اردک پلاستیکی‌ام توضیح دادم و خودم پیدایش کردم.

bikeshedding (بایک‌شِدینگ): بحث طولانی سر چیزهای بی‌اهمیت

bike shed یعنی انبارک دوچرخه. داستانش از C. Northcote Parkinson است: کمیته‌ای طرح یک نیروگاه اتمی را در چند دقیقه تأیید می‌کند، چون کسی از آن سر درنمی‌آورد، ولی ساعت‌ها سر رنگ و جنس انبارک دوچرخه‌ی کارمندها بحث می‌کند، چون همه درباره‌اش نظر دارند. bikeshedding یعنی همین: وقت گذاشتن برای جزئیات آسان و فراموش کردن کار اصلی.

We spent an hour bikeshedding over the name of one variable.

یک ساعت سر اسم یک متغیر بحث بیهوده کردیم.

yak shaving (یَک شِیوینگ): زنجیره‌ی کارهای فرعی پیش از کار اصلی

yak گاو پشمالوی کوهستان‌های تبت است و shave یعنی تراشیدن مو. می‌خواهی یک باگ را درست کنی؛ برایش باید کتابخانه را به‌روز کنی؛ برای آن باید پایتون را به‌روز کنی؛ برای آن باید... و چند ساعت بعد می‌بینی داری کاری می‌کنی که به اندازه‌ی تراشیدن پشم یک یاک از هدف اولت دور است. این اصطلاح حدود سال ۲۰۰۰ در آزمایشگاه هوش مصنوعی MIT ساخته شد و اسمش را از یک کارتون گرفته‌اند.

I wanted to fix one typo and ended up yak shaving all day.

می‌خواستم یک غلط املایی را درست کنم و آخرش کل روز درگیر کارهای فرعی شدم.

reinvent the wheel (ری‌اینوِنت دِ ویل): چرخ را از نو اختراع کردن

invent یعنی اختراع کردن، re- یعنی دوباره و wheel یعنی چرخ. چرخ هزاران سال پیش اختراع شده و خوب هم کار می‌کند؛ دوباره اختراع کردنش وقت تلف کردن است. در برنامه‌نویسی یعنی چیزی را از صفر بنویسی که یک کتابخانه‌ی آماده و آزموده برایش هست، مثل نوشتن تابع مرتب‌سازی خودت. فارسی هم دقیقاً همین را می‌گوید.

Do not reinvent the wheel, use the date library instead.

چرخ را از نو اختراع نکن، به جایش از کتابخانه‌ی تاریخ استفاده کن.

low-hanging fruit (لُو هَنگینگ فروت): کار آسان و پرفایده؛ میوه‌ی دمِ دست

low یعنی پایین، hang یعنی آویزان بودن و fruit یعنی میوه. میوه‌های شاخه‌های پایین را بدون نردبان می‌چینی؛ اول سراغ همان‌ها می‌روی. در کار یعنی کارهایی که با زحمت کم، نتیجه‌ی خوبی می‌دهند: باگ‌های آسان، بهینه‌سازی‌های یک‌خطی. وقتی تیم می‌گوید «اول low-hanging fruit»، یعنی از آسان‌ترین بُردها شروع کنیم.

Let's start with the low-hanging fruit: fix the broken links first.

بیایید از کارهای آسان شروع کنیم: اول لینک‌های خراب را درست کنیم.

silver bullet (سیلوِر بولِت): راه‌حل جادویی که همه‌چیز را حل کند

silver یعنی نقره و bullet یعنی گلوله. در افسانه‌های اروپایی، گرگینه را فقط با گلوله‌ی نقره‌ای می‌شد کشت: یک تیر، و هیولا تمام. در نرم‌افزار یعنی ابزار یا روشی که قرار است همه‌ی مشکل‌ها را یک‌جا حل کند. تقریباً همیشه منفی می‌آید، چون Fred Brooks در مقاله‌ی معروفش در سال ۱۹۸۶ نوشت: No Silver Bullet، یعنی چنین چیزی وجود ندارد.

A new framework is not a silver bullet for our slow pages.

یک فریم‌ورک تازه راه‌حل جادویی صفحه‌های کند ما نیست.

single source of truth (سینگِل سورس آو تِروث): تنها مرجع درست و معتبر یک داده

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

The database is our single source of truth for prices.

پایگاه داده تنها مرجع معتبر ما برای قیمت‌هاست.

works on my machine (وُرکس آن مای مَشین): روی کامپیوتر من که کار می‌کند!

machine یعنی دستگاه، و این‌جا یعنی کامپیوتر خود برنامه‌نویس. معروف‌ترین بهانه‌ی دنیای برنامه‌نویسی است: کسی می‌گوید برنامه خراب است و برنامه‌نویس جواب می‌دهد «روی سیستم من که کار می‌کند». معمولاً هم راست می‌گوید؛ فرق در نسخه‌ی پایتون، یک فایل تنظیمات یا یک کتابخانه‌ی نصب‌نشده است. ابزارهایی مثل Docker برای حل همین درد ساخته شدند.

It works on my machine, so the problem must be in the config.

روی سیستم من کار می‌کند، پس مشکل باید از تنظیمات باشد.

چت دو همکار

Ali: The tests pass on my laptop but fail on the server.
Sara: Ha, the classic: works on my machine! Did you try the rubber duck?
Ali: Yes. Then I started to update one library, then Node, then my whole system. Three hours of yak shaving.
Sara: Maybe don't reinvent the wheel. The team already has a setup script.
Ali: Is it up to date?
Sara: It reads all versions from one file. That file is our single source of truth.
Ali: OK. A script is not a silver bullet, but I will try it.

علی: تست‌ها روی لپ‌تاپ من قبول می‌شوند ولی روی سرور رد.
سارا: ها، همان جمله‌ی همیشگی: روی سیستم من که کار می‌کند! اردک پلاستیکی را امتحان کردی؟
علی: آره. بعد شروع کردم یک کتابخانه را به‌روز کنم، بعد Node را، بعد کل سیستمم را. سه ساعت کار فرعی پشت کار فرعی.
سارا: شاید بهتر باشد چرخ را از نو اختراع نکنی. تیم از قبل یک اسکریپت نصب دارد.
علی: به‌روز است؟
سارا: همه‌ی نسخه‌ها را از یک فایل می‌خواند. آن فایل تنها مرجع معتبر ماست.
علی: باشد. اسکریپت راه‌حل جادویی نیست، ولی امتحانش می‌کنم.