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