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