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