เราได้รวบรวมรายการกฎที่แนะนำไว้ในเอกสารประกอบ
นี่คือชุดกฎคุณภาพสูงซึ่งจะช่วยให้ผู้ใช้ของเราได้รับประสบการณ์ที่ดี เราแยกแยะความแตกต่างระหว่างกฎที่รองรับกับกฎหลายร้อยกฎที่พบได้บนอินเทอร์เน็ต
ได้รับการเสนอชื่อ
หากชุดกฎตรงตามข้อกำหนดด้านล่าง ผู้ดูแลกฎจะเสนอชุดกฎให้เป็นส่วนหนึ่งของกฎที่แนะนำได้โดยการส่งปัญหาเกี่ยวกับ GitHub
หลังจากตรวจสอบโดยทีมหลักของ Bazel แล้ว เราจะแนะนำผลิตภัณฑ์ในเว็บไซต์ Bazel
ข้อกำหนดสำหรับผู้ดูแลกฎ
- ชุดกฎมีฟีเจอร์ที่สำคัญซึ่งเป็นประโยชน์สำหรับผู้ใช้ Bazel จำนวนมาก (เช่น การรองรับภาษาที่เป็นที่นิยมอย่างกว้างขวาง)
- ชุดกฎได้รับการดูแลอย่างดี ต้องมีผู้ดูแลที่ใช้งานอยู่อย่างน้อย 2 ราย
- บันทึกชุดกฎไว้อย่างดี มีตัวอย่างและใช้งานง่าย
- ชุดกฎเป็นไปตามแนวทางปฏิบัติแนะนำและมีประสิทธิภาพสูง (ดูคู่มือประสิทธิภาพ)
- ชุดกฎมีการครอบคลุมการทดสอบเพียงพอ
- ชุดกฎจะได้รับการทดสอบใน BuildKite ด้วย Bazel เวอร์ชันล่าสุด การทดสอบควรผ่านเสมอ (เมื่อใช้เป็นเช็คที่ส่งล่วงหน้า)
- ชุดกฎจะได้รับการทดสอบกับการเปลี่ยนแปลงที่กําลังจะเกิดขึ้นซึ่งใช้ร่วมกันไม่ได้ด้วย ปัญหาควรได้รับการแก้ไขภายใน 2 สัปดาห์ คุณควรรายงานปัญหาการย้ายข้อมูลไปยังทีม Basl อย่างรวดเร็ว
ข้อกำหนดสำหรับนักพัฒนาซอฟต์แวร์ Bazel
- กฎที่แนะนำจะได้รับการทดสอบกับ Bazel ล่วงหน้า (อย่างน้อยวันละครั้ง)
- ไม่มีการเปลี่ยนแปลงใดๆ ใน Bazel ที่อาจละเมิดกฎที่แนะนำ (ด้วยชุดธงเริ่มต้น) หากเกิดขึ้น การเปลี่ยนแปลงควรได้รับการแก้ไขหรือย้อนกลับ
การลดระดับ
หากมีข้อกังวลว่าชุดกฎบางชุดไม่เป็นไปตามข้อกำหนดอีกต่อไป คุณควรยื่นปัญหาเกี่ยวกับ GitHub
ผู้ที่ดูแลกฎจะได้รับการติดต่อและต้องตอบกลับภายใน 2 สัปดาห์ จากผลลัพธ์ที่ได้ ทีมหลักของ Bazel อาจตัดสินใจลดระดับชุดกฎดังกล่าว