Nhóm quan tâm đặc biệt về Bazel

Bazel tổ chức các Nhóm quan tâm đặc biệt (SIG) để tập trung cộng tác vào các lĩnh vực cụ thể và hỗ trợ việc giao tiếp cũng như điều phối giữa chủ sở hữu, người duy trì và người đóng góp của Bazel. Chính sách này áp dụng cho bazelbuild.

Các SIG thực hiện công việc của mình một cách công khai. Phạm vi lý tưởng cho một SIG bao gồm một miền được xác định rõ ràng trong đó phần lớn sự tham gia là từ cộng đồng. Các SIG có thể tập trung vào các kho lưu trữ do cộng đồng duy trì trong bazelbuild (chẳng hạn như quy tắc ngôn ngữ) hoặc tập trung vào các khu vực mã trong kho lưu trữ Bazel (chẳng hạn như Thực thi từ xa).

Mặc dù không phải tất cả các SIG đều có cùng mức độ năng lượng, phạm vi rộng hoặc mô hình quản trị, nhưng phải có đủ bằng chứng cho thấy có các thành viên cộng đồng sẵn sàng tham gia và đóng góp nếu nhóm quan tâm được thành lập. Trước khi tham gia, hãy xem xét công việc của nhóm, sau đó liên hệ với trưởng nhóm SIG. Chính sách thành viên thay đổi theo từng SIG.

Xem danh sách đầy đủ các SIG của Bazel.

Mục tiêu không phải: SIG không phải là gì

Các SIG được thiết kế để tạo điều kiện cộng tác trong công việc được chia sẻ. Do đó, SIG là:

• Không phải là diễn đàn hỗ trợ: danh sách gửi thư và SIG không giống nhau
• Không bắt buộc ngay lập tức: ở giai đoạn đầu trong vòng đời của một dự án, bạn có thể không biết liệu mình có công việc được chia sẻ hay cộng tác viên hay không
• Không phải là lao động miễn phí: cần có năng lượng để phát triển và điều phối công việc một cách cộng tác

Chủ sở hữu Bazel áp dụng phương pháp thận trọng đối với việc tạo SIG. Nhờ tính dễ dàng khi bắt đầu các dự án trên GitHub, có nhiều cách để cộng tác mà không cần đến SIG.

Vòng đời SIG

Phần này trình bày cách tạo SIG.

Nghiên cứu và tư vấn

Để đề xuất một nhóm SIG mới, trước tiên, hãy thu thập bằng chứng để được phê duyệt như được chỉ định bên dưới. Một số cách có thể cân nhắc là:

• Một vấn đề hoặc tập hợp các vấn đề được xác định rõ ràng mà nhóm sẽ giải quyết
• Tư vấn với các thành viên cộng đồng sẽ được hưởng lợi, đánh giá cả lợi ích và sự sẵn sàng cam kết của họ
• Đối với các dự án hiện có, bằng chứng từ các vấn đề và yêu cầu kéo (PR) mà người đóng góp quan tâm đến chủ đề này
• Các mục tiêu tiềm năng mà nhóm cần đạt được
• Yêu cầu về tài nguyên để chạy nhóm

Ngay cả khi nhu cầu về SIG có vẻ hiển nhiên, thì việc nghiên cứu và tư vấn vẫn rất quan trọng đối với sự thành công của nhóm.

Tạo nhóm mới

Nhóm mới phải tuân theo quy trình bên dưới để cấp phép. Cụ thể, nhóm phải chứng minh:

• Mục đích và lợi ích rõ ràng đối với Bazel (hoặc xung quanh một dự án phụ hoặc lĩnh vực ứng dụng)
• Hai hoặc nhiều người đóng góp sẵn sàng đóng vai trò là trưởng nhóm, sự tồn tại của những người đóng góp khác và bằng chứng về nhu cầu đối với nhóm
• Mỗi nhóm cần sử dụng ít nhất một danh sách gửi thư có thể truy cập công khai. SIG có thể sử dụng lại một trong các danh sách công khai, chẳng hạn như bazel-discuss, yêu cầu danh sách cho @bazel.build hoặc tạo danh sách riêng
• Các tài nguyên mà SIG yêu cầu ban đầu (thường là danh sách gửi thư và cuộc gọi video thường xuyên ).
• Các SIG có thể phân phát tài liệu và tệp từ thư mục của chúng trong bazelbuild/community hoặc từ kho lưu trữ riêng của chúng trong tổ chức GitHub bazelbuild. Các SIG có thể liên kết đến các tài nguyên bên ngoài nếu chọn sắp xếp công việc bên ngoài tổ chức GitHub bazelbuild
• Chủ sở hữu Bazel phê duyệt hoặc từ chối các đơn đăng ký SIG và tham khảo ý kiến của các bên liên quan khác khi cần

Trước khi tham gia vào các phần chính thức của quy trình, bạn nên tham khảo ý kiến của nhóm sản phẩm Bazel tại product@bazel.build. Hầu hết các SIG đều yêu cầu trao đổi và lặp lại trước khi phê duyệt.

Yêu cầu chính thức cho nhóm mới được thực hiện bằng cách gửi một bản điều lệ dưới dạng yêu cầu kéo (PR) đến bazelbuild/community, và đưa yêu cầu vào phần nhận xét về yêu cầu kéo (PR) theo mẫu bên dưới. Sau khi được phê duyệt, yêu cầu kéo (PR) cho nhóm sẽ được hợp nhất và các tài nguyên cần thiết sẽ được tạo.

Yêu cầu mẫu cho SIG mới

Để yêu cầu một SIG mới, hãy sử dụng mẫu trong kho lưu trữ cộng đồng: SIG-request-template.md.

Cấp phép

Để thành lập một nhóm, bạn cần có bản điều lệ và phải tuân theo quy tắc ứng xử của Bazel code of conduct. Bản lưu trữ của nhóm sẽ ở chế độ công khai. Thành viên có thể mở cho tất cả mọi người mà không cần phê duyệt hoặc có sẵn theo yêu cầu, đang chờ quản trị viên nhóm phê duyệt.

Bản điều lệ phải đề cử một quản trị viên. Ngoài quản trị viên, nhóm phải có ít nhất một người đóng vai trò là trưởng nhóm (có thể là cùng một người), người này đóng vai trò là điểm liên hệ để điều phối khi cần thiết với nhóm sản phẩm Bazel.

Người tạo nhóm phải đăng bản điều lệ của họ lên danh sách gửi thư của nhóm. Kho lưu trữ cộng đồng trong tổ chức Bazel GitHub lưu trữ các tài liệu và chính sách như vậy. Khi các nhóm phát triển các phương pháp và quy ước của mình, họ nên cập nhật bản điều lệ trong phần có liên quan của kho lưu trữ cộng đồng.

Cộng tác và bao gồm

Mặc dù không bắt buộc, nhưng nhóm nên chọn sử dụng tính năng cộng tác thông qua các cuộc gọi hội nghị theo lịch trình hoặc kênh trò chuyện để tiến hành cuộc họp. Mọi cuộc họp như vậy đều phải được quảng cáo trên danh sách gửi thư và ghi chú được đăng lên danh sách gửi thư sau đó. Các cuộc họp thường xuyên giúp thúc đẩy trách nhiệm giải trình và tiến độ trong một SIG.

Các thành viên nhóm sản phẩm Bazel có thể chủ động theo dõi và khuyến khích nhóm thảo luận và hành động khi thích hợp.

Ra mắt SIG

Các hoạt động bắt buộc:

• Thông báo cho các nhóm thảo luận chung của Bazel (bazel-discuss, bazel-dev).

Các hoạt động không bắt buộc:

• Tạo bài đăng trên blog cho blog Bazel

Tình trạng và chấm dứt hoạt động của các SIG

Chủ sở hữu Bazel cố gắng hết sức để đảm bảo tình trạng của các SIG. Chủ sở hữu Bazel thỉnh thoảng yêu cầu trưởng nhóm SIG báo cáo về công việc của SIG để thông báo cho cộng đồng Bazel rộng hơn về hoạt động của nhóm.

Nếu một SIG không còn mục đích hữu ích hoặc cộng đồng quan tâm, thì SIG đó có thể được lưu trữ và ngừng hoạt động. Nhóm sản phẩm Bazel có quyền lưu trữ các SIG không hoạt động như vậy để duy trì tình trạng chung của dự án, mặc dù đây là kết quả ít được ưu tiên hơn. SIG cũng có thể chọn giải tán nếu nhận thấy rằng SIG đã kết thúc vòng đời hữu ích.

Lưu ý

Nội dung này được lấy từ sổ tay SIG của Tensorflow và đã được sửa đổi.