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