فاز 9: نوشتن
کامنت، پیام commit، README، گزارش باگ و ایمیل: کوتاه، روشن و درست بنویس.
درس 1: کامنت
- code comment: توضیحی که برای آدمها کنار کد مینویسی
- TODO: کاری که هنوز باید انجام شود
- FIXME: نشانهی کدی که خراب است و باید درست شود
- docstring: متن راهنمای یک تابع، درون خود کد
- description: توضیح، شرح
- summary: خلاصه
- explanation: توضیحِ دلیل یا روش کار
- readable: خوانا، راحت برای خواندن
درس 2: پیام commit
- commit message: پیام کوتاهی که میگوید این commit چه کرده
- implement: پیادهسازی کردن؛ یک ایده را به کد تبدیل کردن
- refactor: مرتب کردن کد بدون عوض کردن کاری که میکند
- cleanup: پاکسازی، جمعوجور کردن
- bump: بالا بردن شمارهی نسخه
- initial commit: اولین commit یک پروژه
- minor: کوچک، جزئی، کماهمیت
- major: بزرگ، اساسی، مهم
درس 3: README
- introduction: مقدمه، معرفی
- table of contents: فهرست مطالب
- screenshot: عکسی که از صفحهی نمایش گرفته میشود
- demo: نمایش زنده یا نسخهی نمونهی یک برنامه
- contributing: راهنمای مشارکت در پروژه
- credits: قدردانی از سازندهها و منبعها
- roadmap: نقشهی راه؛ برنامهی آیندهی پروژه
- FAQ: پرسشهای پرتکرار
درس 4: گزارش باگ
- bug report: گزارش باگ
- feature request: درخواست یک قابلیت تازه
- steps to reproduce: قدمهایی که باگ را دوباره میسازد
- expected behavior: رفتاری که انتظار داشتی ببینی
- actual behavior: رفتاری که واقعاً دیدی
- severity: شدت؛ میزان خرابیای که یک باگ میزند
- priority: اولویت؛ اینکه کدام کار زودتر انجام شود
- attachment: پیوست؛ فایلی که همراه پیام میفرستی
درس 5: بازبینی کد
- looks good: خوب به نظر میرسد؛ تأیید میکنم
- nitpick: ایراد خیلی ریز و سلیقهای
- request changes: درخواست تغییر پیش از تأیید
- feedback: بازخورد؛ نظر دیگران دربارهی کار تو
- proposal: پیشنهاد رسمی و نوشتهشده
- draft: پیشنویس؛ نسخهی هنوز ناتمام
- ready for review: آماده برای بازبینی
- follow-up: کار یا پیامِ بعدی که دنبالهی همین موضوع است
درس 6: ایمیل کاری
- subject: موضوع (عنوان) ایمیل
- best regards: با احترام (پایان ایمیل)
- attached: پیوستشده، ضمیمه
- regarding: دربارهی، در مورد
- reminder: یادآوری
- schedule: زمان چیزی را تعیین کردن؛ برنامهی زمانی
- meeting: جلسه
- invite: دعوت کردن؛ دعوتنامه
درس 7: کِی؟
- currently: در حال حاضر، فعلاً
- already: از قبل، قبلاً (زودتر از انتظار)
- yet: هنوز (در جملهی منفی)، تا حالا (در سؤال)
- soon: بهزودی
- recently: اخیراً، بهتازگی
- temporarily: موقتاً، برای مدتی کوتاه
- previously: قبلاً، پیش از این
- eventually: سرانجام، بالاخره (بعد از مدتی)