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