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

Báo cáo vấn đề Xem nguồn Nightly/3}

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ợ giao tiếp và phối hợp giữa chủ sở hữu, người duy trì và người đóng góp của Brazil. Chính sách này áp dụng cho bazelbuild.

Các tổ chức phi lợi nhuận làm việc ở nơi công cộng. Phạm vi lý tưởng cho SIG bao gồm một miền được xác định rõ, nơi phần lớn người 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 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 hoặc mô hình quản trị, nhưng vẫn có đủ bằng chứng cho thấy có đủ thành viên cộng đồng sẵn sàng tương tác và đóng góp nếu nhóm quan tâm được thành lập. Trước khi tham gia, hãy xem lại công việc của nhóm rồi liên hệ với trưởng nhóm SIG. Chính sách về gói thành viên sẽ khác nhau theo từng SSIG.

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

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

Mục đích của SIG là hỗ trợ việc cộng tác trong công việc chung. Do đó, SIG là:

  • Không phải diễn đàn hỗ trợ: danh sách gửi thư và SIG không giống nhau
  • Không cần thiết ngay lập tức: trong giai đoạn đầu của một dự án, có thể bạn sẽ không biết liệu mình có chung tác phẩm hoặc cộng tác viên hay không
  • Không phải lao động tự do: cần 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 cách tiếp cận thận trọng khi tạo SIG – nhờ dễ dàng khởi động dự án trên GitHub, nên có nhiều cách để cộng tác mà không cần SIG.

Vòng đời SIG

Phần này đề cập đến 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 để phê duyệt, như nêu dưới đây. Bạn có thể cân nhắc một số phương án như sau:

  • Một vấn đề hoặc một tập hợp các 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 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 tại, bằng chứng từ các vấn đề và nội dung PR mà cộng tác viên quan tâm về chủ đề
  • Các mục tiêu tiềm năng mà nhóm cần đạt được
  • Các yêu cầu về tài nguyên để điều hành nhóm

Ngay cả khi nhu cầu thực hiện SIG có vẻ hiển nhiên, hoạt động nghiên cứu và tư vấn vẫn đóng vai trò 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 này phải tuân theo quy trình thuê tàu bên dưới. Cụ thể, đối tượng này phải chứng minh:

  • Mục đích và lợi ích rõ ràng cho Bazel (xoay quanh dự án phụ hoặc lĩnh vực ứng dụng)
  • Hai hoặc nhiều cộng tác viên 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 của 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 cung cấp danh sách cho @bazel.build hoặc tạo danh sách riêng
  • 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 thường).
  • 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 trong tổ chức bazelbuild GitHub. SIG có thể liên kết với các tài nguyên bên ngoài nếu họ chọn sắp xếp công việc của mình bên ngoài tổ chức GitHub bazelbuild
  • Chủ sở hữu Bazel phê duyệt hoặc từ chối đơn đăng ký SIG và tham khảo ý kiến của các bên liên quan khác khi cần thiết

Trước khi bắt đầu các phần chính thức của quy trình này, 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 trò chuyện và lặp lại trước khi phê duyệt.

Để yêu cầu chính thức cho nhóm mới, bạn cần gửi điều lệ dưới dạng một PR đến bazelbuild/community, đồng thời đưa yêu cầu đó vào phần nhận xét về 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à tạo các tài nguyên bắt buộc.

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.

Thuê tàu

Để thành lập một nhóm, bạn cần có điều lệ và phải tuân thủ quy tắc ứng xử của Bazel. Tệp lưu trữ của nhóm sẽ ở chế độ công khai. Thành viên có thể được cung cấp cho tất cả mọi người mà không cần phê duyệt hoặc được cung cấp theo yêu cầu khi đang 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. Cũng như quản trị viên, nhóm phải có ít nhất một người làm trưởng nhóm (những người này có thể là cùng một người) làm đầu mối liên hệ để điều phối theo yêu cầu với nhóm sản phẩm Bazel.

Người tạo nhóm phải đăng điều lệ của mình 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 đó. Khi các nhóm phát triển phương pháp và quy ước của mình, họ nên cập nhật điều lệ của mình trong phần phù hợp trong 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 tận 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 để tiến hành cuộc họp. Mọi cuộc họp như vậy phải được quảng cáo trên danh sách gửi thư và ghi chú đăng lên danh sách gửi thư sau đó. Các cuộc họp định kỳ giúp nâng cao trách nhiệm giải trình và tiến độ trong SIG.

Các thành viên trong nhóm sản phẩm của 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.

Chạy SIG

Hoạt động bắt buộc:

Hoạt động không bắt buộc:

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

Kiểm soát và chấm dứt SIG

Chủ sở hữu của Bazel luôn nỗ lực hết sức để đảm bảo sức khoẻ của các SIG. Chủ sở hữu Bazel đôi khi 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ày.

Nếu một SIG không còn có 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 giữ quyền lưu trữ các SIG không hoạt động như vậy để duy trì tình trạng tổng thể của dự án, mặc dù đây là một kết quả không được ưa thích hơn. SIG cũng có thể chọn huỷ bỏ nếu nhận thấy đã hết thời gian sử dụng hữu ích.

Lưu ý:

Nội dung này được lấy từ cẩm nang SIG của Tensorflow, trong đó có một số sửa đổi.