หน้านี้สรุปวิธีที่ผู้มีส่วนร่วมสามารถเสนอและทำการเปลี่ยนแปลงฐานโค้ดของ Bazel
- อ่านนโยบายการมีส่วนร่วมของ Bazel
- สร้างปัญหาใน GitHub เพื่อ พูดคุยเกี่ยวกับแผนและการออกแบบ Pull Request ที่เปลี่ยนแปลงหรือเพิ่มลักษณะการทำงานต้องมีปัญหาที่เกี่ยวข้องสำหรับการติดตาม
- หากต้องการเสนอการเปลี่ยนแปลงที่สำคัญ ให้เขียน เอกสารการออกแบบ
- ตรวจสอบว่าคุณได้ลงนามในข้อตกลงใบอนุญาตผู้มีส่วนร่วม แล้ว
- เตรียมการคอมมิต Git ที่ใช้ฟีเจอร์ อย่าลืมเพิ่มการทดสอบและอัปเดตเอกสารประกอบ หากการเปลี่ยนแปลงของคุณมีผลกระทบที่ผู้ใช้มองเห็นได้ โปรด เพิ่มหมายเหตุประจำรุ่น หากเป็นการเปลี่ยนแปลงที่ไม่เข้ากัน อ่านคำแนะนำสำหรับการเปิดตัวการเปลี่ยนแปลงที่ทำให้เกิดข้อผิดพลาด
- สร้าง Pull Request ใน GitHub. หากไม่เคยใช้ GitHub มาก่อน โปรดอ่านเกี่ยวกับ Pull Request โปรดทราบว่า เราจำกัดสิทธิ์ในการสร้างสาขาในที่เก็บ Bazel หลัก ดังนั้น คุณจะต้องพุชการคอมมิตไปยัง Fork ของ ที่เก็บของคุณเอง
- ผู้ดูแล Bazel ควรมอบหมายผู้ตรวจทานให้คุณภายใน 7 วันทำการ (ไม่รวมวันหยุดในสหรัฐอเมริกาและเยอรมนี) หากไม่ได้รับมอบหมายผู้ตรวจทานภายในระยะเวลาดังกล่าว คุณสามารถปิง
@bazelbuild/triageใน PR ได้ - ทำงานร่วมกับผู้ตรวจทานเพื่อทำการตรวจสอบโค้ดให้เสร็จสมบูรณ์ สร้างการคอมมิตใหม่และพุชการคอมมิตนั้นสำหรับการเปลี่ยนแปลงแต่ละรายการเพื่อทำการเปลี่ยนแปลง Pull Request หากการตรวจสอบใช้เวลานานเกินไป (เช่น ผู้ตรวจทานไม่ตอบสนอง) คุณสามารถปิง
@bazelbuild/triageใน PR ได้ หลังจากที่การตรวจสอบเสร็จสมบูรณ์ ผู้ดูแล Bazel จะใช้แพตช์ของคุณกับระบบควบคุมเวอร์ชันภายในของ Google
ซึ่งจะทริกเกอร์การตรวจสอบก่อนส่งภายในที่อาจแนะนำให้ทำการเปลี่ยนแปลงเพิ่มเติม หากคุณไม่ได้ระบุความต้องการ ผู้ดูแลที่ส่งการเปลี่ยนแปลงของคุณอาจเพิ่มการเปลี่ยนแปลง "เล็กน้อย" (เช่น การ Linting) ที่ไม่ส่งผลต่อ การออกแบบ หากจำเป็นต้องทำการเปลี่ยนแปลงที่ลึกซึ้งกว่านี้ หรือคุณต้องการใช้การเปลี่ยนแปลงโดยตรง คุณและผู้ตรวจทานควรสื่อสารความต้องการอย่างชัดเจนในความคิดเห็นการตรวจสอบ
หลังจากส่งภายในแล้ว ระบบจะส่งออกแพตช์เป็นการคอมมิต Git ซึ่งในจุดนี้ระบบจะปิด Pull Request ของ GitHub การเปลี่ยนแปลงขั้นสุดท้ายทั้งหมดจะระบุแหล่งที่มาเป็นของคุณ