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