Bazel โฮสต์กลุ่มที่มีความสนใจพิเศษ (SIG) เพื่อมุ่งเน้นการทำงานร่วมกันในด้านที่เฉพาะเจาะจง และเพื่อสนับสนุนการสื่อสารและการประสานงานระหว่างเจ้าของ Bazel ผู้ดูแล และผู้ที่มีส่วนร่วม นโยบายนี้มีผลกับ bazelbuild
SIG ทํางานแบบเปิดเผย ขอบเขตที่เหมาะสมสำหรับ SIG จะครอบคลุมโดเมนที่กําหนดไว้อย่างชัดเจน ซึ่งการเข้าร่วมส่วนใหญ่มาจากชุมชน SIG อาจมุ่งเน้นที่ที่เก็บข้อมูลที่ชุมชนดูแลรักษาใน bazelbuild
(เช่น กฎภาษา) หรือมุ่งเน้นที่ส่วนต่างๆ ของโค้ดในที่เก็บข้อมูล Bazel (เช่น การดำเนินการระยะไกล)
แม้ว่า SIG บางกลุ่มอาจไม่ได้มีความกระตือรือร้น ขอบเขตที่กว้างขวาง หรือรูปแบบการกํากับดูแลในระดับเดียวกัน แต่ควรมีหลักฐานเพียงพอว่าสมาชิกชุมชนยินดีที่จะมีส่วนร่วมและสนับสนุนหากมีการจัดตั้งกลุ่มความสนใจ ก่อนเข้าร่วม ให้ตรวจสอบงานของกลุ่ม แล้วติดต่อหัวหน้า SIG นโยบายการเป็นสมาชิกจะแตกต่างกันไปตามแต่ละ SIG
ดูรายการSIG ของ Bazel ทั้งหมด
สิ่งที่ไม่ใช่เป้าหมาย: สิ่งที่ SIG ไม่ใช่
SIG มีไว้เพื่ออำนวยความสะดวกในการทำงานร่วมกันในโปรเจ็กต์ที่แชร์ ดังนั้น SIG จึงมีลักษณะดังนี้
- ไม่ใช่ฟอรัมการสนับสนุน: รายชื่ออีเมลและ SIG ไม่ใช่สิ่งเดียวกัน
- ไม่จําเป็นในทันที: ในช่วงเริ่มต้นของโปรเจ็กต์ คุณอาจไม่ทราบว่าตัวเองมีงานหรือผู้ทำงานร่วมกันที่แชร์หรือไม่
- ไม่ใช่แรงงานฟรี: ต้องมีพลังงานในการทํางานและประสานงานร่วมกัน
เจ้าของ Bazel ใช้แนวทางแบบอนุรักษ์นิยมในการสร้าง SIG เนื่องจากการสร้างโปรเจ็กต์ใน GitHub นั้นง่ายมาก จึงมีช่องทางมากมายที่คุณสามารถทำงานร่วมกันได้โดยไม่ต้องมี SIG
วงจร SIG
ส่วนนี้จะกล่าวถึงวิธีสร้าง SIG
การวิจัยและการปรึกษา
หากต้องการเสนอกลุ่ม SIG ใหม่ ให้รวบรวมหลักฐานเพื่อขออนุมัติก่อน ตามที่ระบุไว้ด้านล่าง ช่องทางที่เป็นไปได้บางส่วนที่ควรพิจารณามีดังนี้
- ปัญหาหรือชุดปัญหาที่กําหนดไว้อย่างชัดเจนซึ่งกลุ่มจะแก้ปัญหา
- การให้คำปรึกษากับสมาชิกชุมชนที่จะได้รับประโยชน์ โดยประเมินทั้งประโยชน์และความเต็มใจที่จะให้ความร่วมมือ
- สำหรับโปรเจ็กต์ที่มีอยู่ ให้ใช้หลักฐานจากปัญหาและ PR ที่แสดงให้เห็นว่าผู้มีส่วนร่วมสนใจหัวข้อนั้น
- เป้าหมายที่เป็นไปได้ที่กลุ่มจะบรรลุ
- ข้อกําหนดด้านทรัพยากรของกลุ่ม
แม้ว่าความต้องการ SIG จะชัดเจนอยู่แล้ว แต่การวิจัยและการปรึกษายังคงมีความสำคัญต่อความสำเร็จของกลุ่ม
สร้างกลุ่มใหม่
กลุ่มใหม่ควรปฏิบัติตามกระบวนการด้านล่างสำหรับการกำหนดข้อบังคับ โดยเฉพาะอย่างยิ่ง เนื้อหาต้องแสดงให้เห็นถึงสิ่งต่อไปนี้
- วัตถุประสงค์และประโยชน์ที่ชัดเจนของ Bazel (สำหรับโปรเจ็กต์ย่อยหรือพื้นที่แอปพลิเคชัน)
- ผู้มีส่วนร่วมอย่างน้อย 2 คนที่ต้องการทำหน้าที่เป็นหัวหน้ากลุ่ม การมีผู้มีส่วนร่วมคนอื่นๆ และหลักฐานแสดงดีมานด์ของกลุ่ม
- แต่ละกลุ่มต้องใช้รายชื่ออีเมลที่เข้าถึงได้แบบสาธารณะอย่างน้อย 1 รายการ SIG อาจนํารายการสาธารณะรายการใดรายการหนึ่งมาใช้ซ้ำ เช่น bazel-discuss ขอรายการสำหรับ @bazel.build หรือสร้างรายการของตนเอง
- ทรัพยากรที่ SIG ต้องการในขั้นต้น (โดยปกติคือรายชื่ออีเมลและวิดีโอคอลปกติ)
- SIG สามารถแสดงเอกสารและไฟล์จากไดเรกทอรีใน
bazelbuild/community
หรือจากที่เก็บของตนเองในองค์กร GitHub ของbazelbuild
SIG อาจลิงก์ไปยังแหล่งข้อมูลภายนอกได้หากเลือกจัดระเบียบงานของตนนอกองค์กรbazelbuild
GitHub - เจ้าของ Bazel จะอนุมัติหรือปฏิเสธใบสมัคร SIG และปรึกษาผู้มีส่วนเกี่ยวข้องอื่นๆ ตามความจำเป็น
ก่อนเข้าสู่กระบวนการอย่างเป็นทางการ คุณควรปรึกษาทีมผลิตภัณฑ์ Bazel ที่ product@bazel.build SIG ส่วนใหญ่ต้องมีการสนทนาและการปรับปรุงก่อนได้รับอนุมัติ
การขอกลุ่มใหม่อย่างเป็นทางการทำได้โดยการส่งกฎบัตรเป็น PR ไปยัง bazelbuild/community
และใส่คำขอในความคิดเห็นของ PR ตามเทมเพลตด้านล่าง เมื่อได้รับอนุมัติ ระบบจะผสาน PR ของกลุ่มและสร้างทรัพยากรที่จำเป็น
คำขอเทมเพลตสำหรับ SIG ใหม่
หากต้องการขอ SIG ใหม่ ให้ใช้เทมเพลตในพื้นที่เก็บข้อมูลของชุมชน ดังนี้ SIG-request-template.md
การเช่า
หากต้องการจัดตั้งกลุ่ม คุณต้องมีกฎบัตรและต้องปฏิบัติตามหลักจรรยาบรรณของ Bazel บันทึกของกลุ่มจะเป็นแบบสาธารณะ การเป็นสมาชิกอาจเปิดกว้างสำหรับทุกคนโดยไม่มีการอนุมัติ หรือเปิดให้สมัครเข้าร่วมโดยรอการอนุมัติจากผู้ดูแลระบบกลุ่ม
กฎบัตรต้องเสนอผู้ดูแลระบบ นอกเหนือจากผู้ดูแลระบบแล้ว กลุ่มต้องมีหัวหน้าอย่างน้อย 1 คน (อาจเป็นบุคคลเดียวกัน) ซึ่งทำหน้าที่เป็นผู้ติดต่อสำหรับการประสานงานตามที่ทีมผลิตภัณฑ์ Bazel กำหนด
ครีเอเตอร์กลุ่มต้องโพสต์กฎบัตรไปยังรายชื่ออีเมลของกลุ่ม ที่เก็บของชุมชนในองค์กร GitHub ของ Bazel จะเก็บเอกสารและนโยบายดังกล่าว เมื่อกลุ่มพัฒนาแนวทางปฏิบัติและแบบแผนต่างๆ ขึ้น ก็ควรอัปเดตกฎบัตรภายในส่วนที่เกี่ยวข้องของที่เก็บข้อมูลชุมชน
การทำงานร่วมกันและการรวมเข้าด้วยกัน
แม้ว่าจะไม่ได้บังคับ แต่กลุ่มควรเลือกใช้การทำงานร่วมกันผ่านการประชุมทางโทรศัพท์ที่กำหนดเวลาไว้หรือแชแนลแชทเพื่อจัดการประชุม ควรโฆษณาการประชุมดังกล่าวในรายชื่ออีเมล และโพสต์บันทึกในรายชื่ออีเมลในภายหลัง การประชุมเป็นประจำจะช่วยเพิ่มความรับผิดชอบและการพัฒนาใน SIG
สมาชิกทีมผลิตภัณฑ์ Bazel อาจตรวจสอบและกระตุ้นให้กลุ่มพูดคุยและดำเนินการตามความเหมาะสม
เปิด SIG
กิจกรรมที่จําเป็น
- แจ้งกลุ่มสนทนาทั่วไปของ Bazel (bazel-discuss, bazel-dev)
กิจกรรมที่ไม่บังคับ
- สร้างบล็อกโพสต์สำหรับบล็อก Bazel
สถานะและการสิ้นสุดของ SIG
เจ้าของ Bazel จะพยายามอย่างเต็มที่เพื่อรักษาสถานะของ SIG เจ้าของ Bazel จะขอให้หัวหน้า SIG รายงานเกี่ยวกับงานของ SIG เป็นครั้งคราว เพื่อแจ้งให้ชุมชน Bazel ที่กว้างขึ้นทราบถึงกิจกรรมของกลุ่ม
หาก SIG ไม่มีวัตถุประสงค์ที่เป็นประโยชน์หรือชุมชนที่สนใจอีกต่อไป เราอาจเก็บ SIG นั้นและหยุดการดำเนินการ ทีมผลิตภัณฑ์ Bazel ขอสงวนสิทธิ์ในการเก็บ SIG ที่ไม่ได้ใช้งานดังกล่าวเพื่อรักษาสถานะโดยรวมของโปรเจ็กต์ แม้ว่าจะไม่ใช่ผลลัพธ์ที่ต้องการ SIG อาจเลือกที่จะยุบตัวหากเห็นว่าถึงเวลาสิ้นสุดการใช้งานแล้ว
หมายเหตุ
เนื้อหานี้นำมาจากPlaybook ของ SIG ของ Tensorflow โดยมีการแก้ไข