นโยบายการมีส่วนร่วม

translation: human page_type: lcat

หน้านี้ครอบคลุมรูปแบบการกำกับดูแลและนโยบายการมีส่วนร่วมของ Bazel

โมเดลการกำกับดูแล

โปรเจ็กต์ Bazel มี Google เป็นผู้นำและผู้จัดการ และมีชุมชนผู้ร่วมให้ข้อมูลขนาดใหญ่ที่อยู่นอก Google คอมโพเนนต์ Bazel บางอย่าง (เช่น ที่เก็บกฎที่เฉพาะเจาะจงภายใต้องค์กร bazelbuild) ได้รับการนำ การดูแลรักษา และการจัดการโดยสมาชิกในชุมชน ทีม Google Bazel จะตรวจสอบคำแนะนำในการเพิ่มที่เก็บที่ชุมชนเป็นเจ้าของ (เช่น กฎ) ลงในองค์กร bazelbuild ใน GitHub

บทบาทของผู้มีส่วนร่วม

ต่อไปนี้คือโครงร่างของบทบาทในโปรเจ็กต์ Bazel รวมถึงความรับผิดชอบของแต่ละบทบาท

  • เจ้าของ: ทีม Bazel ของ Google เจ้าของมีหน้าที่รับผิดชอบในสิ่งต่อไปนี้
    • กลยุทธ์ การบำรุงรักษา และความเป็นผู้นำของโปรเจ็กต์ Bazel
    • การสร้างและบำรุงรักษาฟังก์ชันหลักของ Bazel
    • แต่งตั้งผู้ดูแลและอนุมัติที่เก็บข้อมูลใหม่
  • ผู้ดูแล: ทีม Google Bazel และผู้ใช้ GitHub ที่ได้รับมอบหมาย ผู้ดูแลมีหน้าที่รับผิดชอบในเรื่องต่อไปนี้
    • การสร้างและดูแลรักษาฟังก์ชันหลักของที่เก็บ
    • ตรวจสอบและอนุมัติการมีส่วนร่วมในส่วนต่างๆ ของโค้ดเบสของ Bazel
    • สนับสนุนผู้ใช้และผู้ร่วมให้ข้อมูลด้วยการจัดการปัญหา การตรวจสอบคำขอแก้ไข และเอกสารประกอบที่โปร่งใสและทันท่วงที
    • การเผยแพร่ การทดสอบ และการทำงานร่วมกับเจ้าของ Bazel
  • ผู้ร่วมให้ข้อมูล: ผู้ใช้ทั้งหมดที่ร่วมให้ข้อมูลโค้ดหรือเอกสารประกอบในโปรเจ็กต์ Bazel
    • การสร้างคำขอส่งที่เขียนได้ดีเพื่อมีส่วนร่วมในโค้ดเบสและ เอกสารประกอบของ Bazel
    • ใช้ช่องทางมาตรฐาน เช่น ปัญหาใน GitHub เพื่อเสนอการเปลี่ยนแปลงและรายงานปัญหา

การเป็นผู้ดูแล

เจ้าของ Bazel อาจแต่งตั้งผู้ดูแลเพื่อเป็นผู้นำในส่วนของโค้ดที่กำหนดไว้อย่างชัดเจน เช่น ชุดกฎ ผู้ร่วมให้ข้อมูลที่มีประวัติการร่วมให้ข้อมูลที่สม่ำเสมอและมีความรับผิดชอบในอดีต ซึ่งวางแผนที่จะร่วมให้ข้อมูลครั้งใหญ่ในอนาคตอาจได้รับการพิจารณา ให้เป็นผู้ดูแลรักษาที่มีคุณสมบัติ

นโยบายการมีส่วนร่วม

โปรเจ็กต์ Bazel ยอมรับการมีส่วนร่วมจากผู้ร่วมให้ข้อมูลภายนอก ต่อไปนี้คือนโยบายการมีส่วนร่วมสำหรับส่วนของโค้ดที่ Google จัดการและชุมชนจัดการ

  • การอนุญาตให้ใช้สิทธิ์ ผู้ดูแลและผู้ร่วมให้ข้อมูลทุกคนต้องลงนามในข้อตกลงการอนุญาตให้ใช้ผลงานของผู้ร่วมให้ข้อมูลของ Google
  • การสนับสนุน เจ้าของและผู้ดูแลควรพยายามอย่างเต็มที่เพื่อยอมรับ การมีส่วนร่วมที่คุ้มค่า การมีส่วนร่วมทั้งหมดต้องมีลักษณะดังนี้
    • เขียนและทดสอบอย่างดี
    • ได้รับการพูดคุยและอนุมัติจากผู้ดูแลส่วนของโค้ดที่เกี่ยวข้อง การสนทนาและการอนุมัติจะเกิดขึ้นในปัญหาของ GitHub และใน PR ของ GitHub การมีส่วนร่วมที่ใหญ่ขึ้นต้องผ่านการตรวจสอบการออกแบบ
    • เพิ่มลงในระบบการผสานรวมอย่างต่อเนื่องของ Bazel หากยังไม่มี
    • รองรับและสอดคล้องกับทิศทางผลิตภัณฑ์ของ Bazel
  • การตรวจสอบโค้ด การเปลี่ยนแปลงทั้งหมดในที่เก็บ bazelbuild ทั้งหมดต้องได้รับการตรวจสอบ
    • คำขอ Pull ทั้งหมดต้องได้รับการอนุมัติจากเจ้าของหรือผู้ดูแล
    • เฉพาะเจ้าของและผู้ดูแลเท่านั้นที่ผสานรวม PR ได้
  • ความเข้ากันได้ เจ้าของอาจต้องปฏิเสธหรือขอแก้ไขคำขอเปลี่ยนแปลง ในกรณีที่การเปลี่ยนแปลงต้องมีการแก้ไขระบบภายในของ Google อย่างมาก ซึ่งมักไม่เกิดขึ้นบ่อยนัก
  • เอกสารประกอบ การมีส่วนร่วมในฟีเจอร์ควรมีการอัปเดตเอกสารประกอบด้วย หากเกี่ยวข้อง

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการมีส่วนร่วมใน Bazel ได้ที่หลักเกณฑ์การมีส่วนร่วม