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