روی یک شاخهٔ فرعی کار کنید، نه روی شاخهٔ main خود.¶
قبل از اینکه روی تغییارتان کار را شروع کنید، مطمئن شوید که یک شاخه ایجاد
کردهاید. بهطور پیشفرض، وقتی فورک مخزن خود را کلون میکنید، روی شاخهٔ main
چکاوت میشوید. این یک کپی مستقیم از شاخهٔ BeeWare در main است.
در حالی که میتوانید از شاخهٔ main خود درخواست کشش ارسال کنید، ترجیح داده
میشود این کار را انجام ندهید. اگر درخواستی ارسال کنید که تقریباً درست باشد، عضو
تیم اصلی که درخواست شما را بررسی میکند ممکن است بتواند تغییرات لازم را اعمال
کند، بهجای اینکه بازخورد دهد و درخواست یک تغییر جزئی کند. با این حال، اگر
درخواست کشش خود را از شاخهٔ main ارسال کنید، بازبینان از انجام اصلاحات منع
میشوند.
کار کردن روی شاخهٔ اصلی شما نیز پس از تکمیل اولین درخواست کشیدن برایتان دشوار
میشود. اگر بخواهید روی دومین درخواست کشیدن کار کنید، به یک نسخهٔ «تمیز» از
شاخهٔ اصلی پروژهٔ بالادست نیاز دارید تا دومین مشارکت خود را بر اساس آن انجام
دهید؛ اگر اولین مشارکت خود را از شاخهٔ main انجام داده باشید، دیگر آن نسخهٔ
تمیز در دسترس شما نخواهد بود.
در عوض، شما باید تغییرات خود را در یک شعبهٔ ویژگی ایجاد کنید. یک شعبهٔ ویژگی
نام سادهای دارد تا تغییری را که ایجاد کردهاید شناسایی کند. برای مثال، اگر در
حال رفع باگی هستید که باعث مشکلات ساخت (build) در ویندوز ۱۱ میشود، ممکن است یک
شاخهٔ ویژگی به نام fix-win11-build ایجاد کنید. اگر باگ شما به یک مشکل خاص که
گزارش شده است مربوط میشود، همچنین رایج است که شمارهٔ آن مشکل را در نام شاخه ذکر
کنید (مثلاً fix-1234).
برای ایجاد یک شاخهٔ ویژگی fix-win11-build، اجرا کنید:
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build