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