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