این صفحه نحوه پیشنهاد و ایجاد تغییرات در پایه کد Bazel را توضیح می دهد.
- خط مشی مشارکت بازل را بخوانید.
- برای بحث در مورد طرح و طرح خود، یک شماره GitHub ایجاد کنید. درخواست‌های کششی که رفتار را تغییر می‌دهند یا اضافه می‌کنند، برای ردیابی به مشکل مربوطه نیاز دارند.
- اگر تغییرات قابل توجهی را پیشنهاد می کنید، یک سند طراحی بنویسید.
- اطمینان حاصل کنید که قرارداد مجوز مشارکت کننده را امضا کرده اید.
- یک git commit که این ویژگی را پیاده سازی می کند، آماده کنید. فراموش نکنید که آزمایش ها را اضافه کنید و اسناد را به روز کنید. اگر تغییر شما دارای اثرات قابل مشاهده برای کاربر است، لطفاً یادداشت‌های انتشار را اضافه کنید . اگر یک تغییر ناسازگار است، راهنمای ایجاد تغییرات قطعی را بخوانید.
- یک درخواست کشش در GitHub ایجاد کنید. اگر تازه وارد GitHub هستید، درباره درخواست‌های کشش مطالعه کنید. توجه داشته باشید که ما مجوزها را برای ایجاد شاخه‌ها در مخزن اصلی Bazel محدود می‌کنیم، بنابراین باید commit خود را به فورک مخزن خود فشار دهید.
- یک نگهدارنده Bazel باید ظرف دو روز کاری (به استثنای تعطیلات در ایالات متحده آمریکا و آلمان) یک بازبین به شما اختصاص دهد. اگر در این مدت بازبینی به شما اختصاص داده نشده است، می‌توانید با ایمیل bazel-dev@googlegroups.com درخواست کنید.
- برای تکمیل بازبینی کد با بازبین کار کنید. برای هر تغییر، یک commit جدید ایجاد کنید و آن را فشار دهید تا تغییراتی در درخواست کشش شما ایجاد شود. اگر بازبینی بیش از حد طولانی شود (مثلاً اگر بازبین پاسخگو نیست)، یک ایمیل به bazel-dev@googlegroups.com ارسال کنید.
پس از تکمیل بررسی شما، یک نگهدارنده Bazel وصله شما را در سیستم کنترل نسخه داخلی Google اعمال می کند.
این کار بررسی‌های پیش‌ارسال داخلی را آغاز می‌کند که ممکن است تغییرات بیشتری را پیشنهاد کند. اگر ترجیحی را بیان نکرده‌اید، نگهدارنده‌ای که تغییر شما را ارسال می‌کند، تغییرات «بی‌اهمیت» (مانند پرزها ) را اضافه می‌کند که بر طراحی تأثیر نمی‌گذارند. اگر تغییرات عمیق‌تری مورد نیاز است یا ترجیح می‌دهید تغییرات را مستقیماً اعمال کنید، شما و بازبین باید اولویت‌ها را به وضوح در نظرات مرور اعلام کنید.
پس از ارسال داخلی، پچ به عنوان یک Git commit صادر می شود، در این مرحله درخواست کشش GitHub بسته می شود. تمام تغییرات نهایی به شما نسبت داده می شود.