Bazel tổ chức các Nhóm lợi ích đặc biệt (SIG) để tập trung cộng tác vào các lĩnh vực cụ thể và hỗ trợ hoạt động giao tiếp cũng như phối hợp 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 nhóm lợi ích đặc biệt (SIG) hoạt động 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, nơi phần lớn sự tham gia là từ cộng đồng. 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 vùng mã trong kho lưu trữ Bazel (chẳng hạn như Thực thi từ xa).
Mặc dù không phải SIG nào cũng 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 lợi ích đượ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 người đứng đầu SIG. Chính sách thành viên sẽ thay đổi theo từng SIG.
Xem danh sách đầy đủ các SIG Bazel.
Những điều không phải là mục tiêu: Những điều mà một Nhóm lợi ích đặc biệt không phải là
SIG được thiết kế để tạo điều kiện cộng tác trong công việc chung. Do đó, SIG là:
- Không phải là diễn đàn hỗ trợ: danh sách gửi thư và SIG không phải là một
- Không bắt buộc ngay lập tức: trong giai đoạn đầu của dự án, bạn có thể không biết liệu mình có công việc chung 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à phối hợp công việc một cách cộng tác
Các chủ sở hữu Bazel áp dụng một cách tiếp cận thận trọng đối với việc tạo SIG. Nhờ việc dễ dàng 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 của SIG
Phần này trình bày cách tạo một 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. Sau đây là một số cách có thể cân nhắc:
- Một vấn đề hoặc nhóm vấn đề được xác định rõ ràng mà nhóm sẽ giải quyết
- Tham khảo ý kiến của những thành viên trong cộng đồng sẽ được hưởng lợi, đánh giá cả lợi ích và mức độ 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 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ó thể đạt được
- Yêu cầu về tài nguyên để chạy nhóm
Ngay cả khi nhu cầu về một 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 cấp phép dưới đây. Cụ thể, bạn phải chứng minh được:
- Mục đích và lợi ích rõ ràng đối với Bazel (liên quan đến một dự án phụ hoặc lĩnh vực ứng dụng)
- Có từ 2 người đóng góp trở lên sẵn sàng đóng vai trò trưởng nhóm, có những người đóng góp khác và có bằng chứng cho thấy nhu cầu về 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 một 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).
- SIG có thể phân phát tài liệu và tệp từ thư mục của họ trong
bazelbuild/community
hoặc từ kho lưu trữ của riêng họ trong tổ chứcbazelbuild
GitHub. SIG có thể liên kết đến các tài nguyên bên ngoài nếu chọn tổ chức công việc bên ngoài tổ chứcbazelbuild
GitHub - Bazel Owners 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 nếu 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 phải có cuộc trò chuyện và quá trình lặp lại trước khi phê duyệt.
Yêu cầu chính thức về nhóm mới được thực hiện bằng cách gửi một điều lệ dưới dạng PR đến bazelbuild/community
và đưa yêu cầu vào phần nhận xét trên PR theo mẫu bên dưới. Sau khi được phê duyệt, 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.
Mẫu yêu cầu về Nhóm lợi ích đặc biệt 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.
Thuê tàu
Để thành lập một nhóm, bạn cần có quy chế và phải tuân thủ quy tắc ứng xử của Bazel. Bản lưu trữ của nhóm sẽ ở chế độ công khai. Tư cách thành viên có thể được mở cho tất cả mọi người mà không cần phê duyệt, hoặc có thể được cung cấp theo yêu cầu, chờ quản trị viên nhóm phê duyệt.
Điều lệ phải chỉ định 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 làm trưởng nhóm (có thể là cùng một người). Người này sẽ đóng vai trò là đầu mối liên hệ để phối hợp khi cần thiết với nhóm sản phẩm Bazel.
Người tạo nhóm phải đăng quy tắc của nhóm vào 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 thay đổi phương pháp và quy ước, họ nên cập nhật điều lệ của mình trong phần có liên quan của kho lưu trữ cộng đồng.
Cộng tác và hoà nhập
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ị hoặc kênh trò chuyện theo lịch để tổ chức cuộc họp. Mọi cuộc họp như vậy đều phải được thông bá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 Nhóm lợi ích đặc biệt.
Các thành viên trong nhóm sản phẩm Bazel có thể chủ động giám sát và khuyến khích nhóm thảo luận cũng như hành động khi thích hợp.
Ra mắt một nhóm lợi ích đặc biệt
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
Sức khoẻ và việc chấm dứt SIG
Các chủ sở hữu Bazel sẽ cố gắng hết sức để đảm bảo sự lành mạnh của các SIG. Đôi khi, chủ sở hữu Bazel 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 lớn hơn về hoạt động của nhóm.
Nếu không còn mục đích hữu ích hoặc cộng đồng quan tâm, 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ữ những SIG không hoạt động như vậy để duy trì trạng thái tổng thể của dự án, mặc dù đây là kết quả ít được ưu tiên hơn. Một SIG cũng có thể chọn giải tán nếu nhận thấy đã kết thúc vòng đời hữu ích của mình.
Lưu ý
Nội dung này được lấy từ sổ tay SIG của Tensorflow và có chỉnh sửa.