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

جست‌وجوی خوب

جست‌وجو کردن هم یک مهارت است. این هشت کلمه کمک می‌کنند درست جست‌وجو کنی و بین نتیجه‌ها، منبع مطمئن و تازه را از کهنه و بی‌ربط جدا کنی.

صفت قبل از اسم

در فارسی صفت بعد از اسم می‌آید: «مستنداتِ رسمی». در انگلیسی برعکس است و صفت قبل از اسم می‌نشیند: official documentation، a trusted source، an outdated tutorial، a relevant result. صفت جمع هم بسته نمی‌شود: relevant results، نه relevants results.

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

keyword (کی‌وِرد): کلیدواژه؛ کلمه‌ی کلیدیِ جست‌وجو

key یعنی کلید و word یعنی کلمه. keyword کلمه‌ی مهمی است که در جست‌وجو می‌نویسی. موتور جست‌وجو جمله‌ی مؤدبانه نمی‌خواهد؛ چند کلیدواژه‌ی درست کافی است: اسم زبان، اسم خطا و کاری که می‌کردی. در زبان‌های برنامه‌نویسی هم keyword داریم: کلمه‌های رزروشده مثل if و for.

Add the keyword "python" to your search to get better results.

کلیدواژه‌ی python را به جست‌وجویت اضافه کن تا نتیجه‌های بهتری بگیری.

search engine (سِرچ اِنجین): موتور جست‌وجو

search یعنی جست‌وجو و engine یعنی موتور. search engine سایتی است که کلمه‌های تو را می‌گیرد و از میان میلیاردها صفحه، مربوط‌ترین‌ها را فهرست می‌کند. برای برنامه‌نویس، بلد بودن جست‌وجو یک مهارت واقعی است: بیشتر خطاها را قبلاً کس دیگری دیده و جوابش جایی نوشته شده است.

Paste the error message into a search engine first.

اول متن خطا را در یک موتور جست‌وجو بچسبان.

exact match (ایگزَکت مَچ): تطابق دقیق، عینِ همان عبارت

exact یعنی دقیق و match یعنی جور بودن. در جست‌وجو، اگر عبارتی را داخل گیومه‌ی انگلیسی بگذاری، فقط صفحه‌هایی می‌آیند که عینِ همان کلمه‌ها را با همان ترتیب دارند. این برای متن خطا عالی است. فقط بخش‌های مخصوص خودت (اسم فایل، اسم متغیر) را از آن بیرون بگذار.

Use quotes to search for an exact match of the error.

برای جست‌وجوی عینِ متن خطا، از گیومه استفاده کن.

relevant (رِلِوِنت): مربوط، مرتبط با موضوع

relevant یعنی مربوط به همان چیزی که دنبالش هستی. نتیجه‌ی جست‌وجو وقتی relevant است که درباره‌ی همان زبان، همان نسخه و همان خطای تو باشد. در سؤال نوشتن هم مهم است: فقط کدِ مربوط را بگذار، نه کل پروژه را.

Please post only the relevant part of your code.

لطفاً فقط بخش مربوطِ کدت را بفرست.

official (آفیشال): رسمی (از طرف خودِ سازنده)

official یعنی رسمی: چیزی که خودِ سازنده‌ها منتشر کرده‌اند. official documentation مستنداتی است که تیم همان زبان یا کتابخانه نوشته است. از هر وبلاگ و ویدیویی مطمئن‌تر است، چون سازنده بهتر از هر کسی می‌داند ابزارش چطور کار می‌کند.

Check the official documentation before you trust a blog post.

قبل از اعتماد به یک نوشته‌ی وبلاگ، مستندات رسمی را نگاه کن.

outdated (اوت‌دِیتِد): قدیمی‌شده، از رده خارج

out یعنی بیرون و date یعنی تاریخ؛ outdated یعنی چیزی که تاریخش گذشته است. دنیای برنامه‌نویسی تند عوض می‌شود: جوابی که پنج سال پیش درست بود، شاید با نسخه‌ی امروز کار نکند. اگر راه‌حلی را کپی کردی و خطای عجیبی گرفتی، اول تاریخش را ببین.

This tutorial is outdated and uses an old version.

این آموزش قدیمی شده و از یک نسخه‌ی کهنه استفاده می‌کند.

up to date (آپ تو دِیت): به‌روز، تازه

up to date یعنی «تا همین تاریخ»: چیزی که با آخرین تغییرها هماهنگ است. مستندات up to date یعنی برای نسخه‌ی امروز نوشته شده است. در ترمینال هم زیاد می‌بینی‌اش: git می‌گوید Already up to date یعنی چیز تازه‌ای برای گرفتن نیست.

Make sure your browser is up to date.

مطمئن شو مرورگرت به‌روز است.

trusted (تراستِد): مورد اعتماد، مطمئن

trust یعنی اعتماد کردن و trusted یعنی چیزی که به آن اعتماد شده است. a trusted source منبعی است که می‌شود به حرفش تکیه کرد: مستندات رسمی، کتاب‌های شناخته‌شده، جواب‌های پررأی. کدی را که از جای ناشناس آمده، نفهمیده اجرا نکن.

Only install packages from a trusted source.

بسته‌ها را فقط از یک منبع مطمئن نصب کن.

پنج نکته برای جست‌وجوی خطا

How to search for an error:

1. Copy the last line of the error into a search engine.
2. Put it in quotes to get an exact match.
3. Add one keyword: the name of your language.
4. Read the most relevant results first, and check the date. An answer from 2012 may be outdated.
5. Prefer the official documentation. It is a trusted source and it is usually up to date.

چطور یک خطا را جست‌وجو کنیم:

۱. خط آخر خطا را در یک موتور جست‌وجو کپی کن.
۲. آن را داخل گیومه بگذار تا عینِ همان عبارت پیدا شود.
۳. یک کلیدواژه اضافه کن: اسم زبانت.
۴. اول مربوط‌ترین نتیجه‌ها را بخوان و تاریخ را نگاه کن. جوابی از سال ۲۰۱۲ شاید قدیمی شده باشد.
۵. مستندات رسمی را ترجیح بده. منبع مطمئنی است و معمولاً به‌روز است.