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