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