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ể
, cũng như hỗ trợ hoạt động giao tiếp và điều phối giữa chủ sở hữu Bazel, người duy trì và người đóng góp. Chính sách này
áp dụng cho bazelbuild.
Các 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, trong đó phần lớn hoạt động 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 phần của 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 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. Các chính sách về thành viên sẽ khác nhau tuỳ theo từng SIG.
Xem danh sách đầy đủ các SIG của Bazel.
Mục tiêu không phải là: 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 chung. 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 của một 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à đ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 khi 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 SIG.
Vòng đời SIG
Phần này trình bày cách tạo SIG.
Nghiên cứu và tham 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 vấn đề được xác định rõ ràng mà nhóm sẽ giải quyết
- Tham 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à tham 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 bên dưới. Cụ thể, nhóm phải chứng minh:
- 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)
- Hai hoặc nhiều người đóng góp sẵn sàng đóng vai trò 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. Một 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ể cung cấp tài liệu và tệp từ thư mục của họ trong
bazelbuild/communityhoặc từ kho lưu trữ riêng của họ trong tổ chức GitHubbazelbuild. 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 GitHubbazelbuild - Chủ sở hữu Bazel phê duyệt hoặc từ chối các đơn đăng ký SIG và tham vấn các bên liên quan khác khi cần
Trước khi tham gia các phần chính thức của quy trình, bạn nên tham vấn 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 đối với 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.
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ó đ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ó thể 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 đóng vai trò 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 với nhóm sản phẩm Bazel.
Người tạo nhóm phải đăng đ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, 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à 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 hoặc kênh trò chuyện để tiến hành các 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à việc 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. Một SIG cũng có thể chọn giải tán nếu nhận thấy đã hết 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.