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