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

کِی؟

وقتی وضعیت یک کار را گزارش می‌دهی، مهم‌ترین سؤال این است: کِی؟ این هشت قید به خواننده می‌گویند چیزی مال گذشته است، الان است یا در راه؛ بدون این‌که تاریخ دقیق بدهی.

جای قید در جمله

این قیدها سه جا می‌نشینند. وسط جمله، قبل از فعل اصلی و بعد از فعل کمکی یا to be: «We have already fixed it»، «It is currently offline»، «It currently supports…». اول جمله با ویرگول: «Previously, …»، «Recently, …»، «Eventually, …». و yet و soon معمولاً آخر جمله: «It is not ready yet»، «It is coming soon». already و yet بیشتر با حال کامل (have + شکل سوم فعل) می‌آیند.

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

currently (کارِنتلی): در حال حاضر، فعلاً

current یعنی «فعلی» و currently یعنی «در حال حاضر». وقتی آن را در یک جمله می‌گذاری، یعنی «الان این‌طور است، ولی شاید عوض شود». در مستندات و گزارش‌ها زیاد می‌آید: «This feature is currently not supported» یعنی فعلاً پشتیبانی نمی‌شود، نه این‌که هیچ‌وقت نخواهد شد.

The app currently supports only English and Persian.

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

already (آل‌رِدی): از قبل، قبلاً (زودتر از انتظار)

already یعنی کاری قبل از این لحظه انجام شده، و معمولاً زودتر از چیزی که فکر می‌کردیم. در پیام‌های خطا زیاد است: «File already exists» یعنی این فایل از قبل هست. در گفت‌وگوی تیمی هم جلوی دوباره‌کاری را می‌گیرد: «I have already fixed it».

I have already pushed the fix to the main branch.

اصلاح را از قبل به شاخه‌ی main فرستاده‌ام.

yet (یِت): هنوز (در جمله‌ی منفی)، تا حالا (در سؤال)

yet یعنی «تا این لحظه». در جمله‌ی منفی می‌گوید کاری هنوز نشده ولی انتظار داریم بشود: «not implemented yet» یعنی هنوز پیاده نشده و در راه است. در سؤال می‌پرسد «تا حالا شده؟»: «Is it ready yet?». تقریباً همیشه آخر جمله می‌نشیند.

This feature is not ready yet, but we are working on it.

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

soon (سون): به‌زودی

soon یعنی «به‌زودی»: در آینده‌ی نزدیک، بدون این‌که تاریخ دقیقی بدهی. «Coming soon» را روی صفحه‌ی قابلیت‌هایی می‌بینی که هنوز آماده نیستند. در نوشته‌ی کاری مراقبش باش: soon برای یکی یعنی فردا و برای دیگری یعنی ماه بعد. اگر تاریخ را می‌دانی، خود تاریخ را بنویس.

A new version with dark mode is coming soon.

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

recently (ریسِنتلی): اخیراً، به‌تازگی

recent یعنی «تازه» و recently یعنی «به‌تازگی»: در گذشته‌ی نزدیک. در گزارش باگ خیلی به درد می‌خورد، چون سرنخ می‌دهد: «این مشکل recently شروع شد» یعنی احتمالاً یکی از تغییرهای آخر مقصر است. صفتش را هم همه‌جا می‌بینی: Recent files، Recently viewed.

This bug appeared recently, after the last update.

این باگ به‌تازگی پیدا شده، بعد از آخرین به‌روزرسانی.

temporarily (تِمپُرِریلی): موقتاً، برای مدتی کوتاه

temporary یعنی «موقت» و temporarily یعنی «به‌طور موقت»: فقط برای مدتی کوتاه و نه برای همیشه. در پیام‌های سرور می‌بینی: «Service temporarily unavailable» یعنی الان در دسترس نیست، کمی بعد دوباره امتحان کن. در کامنت هم با آن می‌گویی این خط همیشگی نیست و باید برگردد.

We temporarily disabled sign-ups while we fix the bug.

تا وقتی باگ را درست می‌کنیم، ثبت‌نام را موقتاً غیرفعال کرده‌ایم.

previously (پریویِسلی): قبلاً، پیش از این

previous یعنی «قبلی» و previously یعنی «پیش از این». وقتی تغییری را توضیح می‌دهی، با این کلمه وضع قدیم را می‌گویی و با now وضع تازه را. این جفت یکی از بهترین الگوها برای بدنه‌ی پیام commit و فهرست تغییرهاست: خواننده در دو جمله می‌فهمد چه چیزی از چه به چه عوض شد.

Previously, the app saved the file on every key press.

قبلاً برنامه با هر بار فشردن کلید، فایل را ذخیره می‌کرد.

eventually (ایوِنچوالی): سرانجام، بالاخره (بعد از مدتی)

eventually یعنی «بالاخره، بعد از گذشت زمان»: معلوم نیست کِی، ولی آخرش می‌شود. در نوشته‌ی فنی برای چیزی می‌آید که بعد از چند بار تلاش یا مدتی انتظار اتفاق می‌افتد: «The request eventually times out». برای برنامه‌های دور هم هست: «Eventually we want to support offline mode».

The page loads eventually, but it takes almost a minute.

صفحه بالاخره بارگذاری می‌شود، ولی نزدیک یک دقیقه طول می‌کشد.

گزارش وضعیت یک مشکل

Status update: file upload

Uploads are currently slow for large files. We have already found the cause: the server reads the whole file into memory. Previously, this was not a problem because files were small. Recently, users started to upload videos.

We have not fixed it yet. For now, we have temporarily set a limit of 50 MB. A real fix is coming soon. Eventually, we want to support files of any size.

گزارش وضعیت: بارگذاری فایل

بارگذاری فایل‌های بزرگ در حال حاضر کند است. دلیلش را از قبل پیدا کرده‌ایم: سرور کل فایل را در حافظه می‌خواند. قبلاً این مشکلی نبود، چون فایل‌ها کوچک بودند. به‌تازگی کاربرها شروع کرده‌اند به بارگذاری ویدیو.

هنوز درستش نکرده‌ایم. فعلاً به‌طور موقت سقف ۵۰ مگابایت گذاشته‌ایم. اصلاح واقعی به‌زودی می‌آید. در نهایت می‌خواهیم از فایل با هر اندازه‌ای پشتیبانی کنیم.