Nhóm sở thích đặc biệt của Bazel

Báo cáo sự cố Xem nguồn

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

SIG hoạt động công khai ở chế độ công khai. Phạm vi lý tưởng cho SIG bao gồm một miền đã xác định rõ, trong đó phần lớn sự tham gia là của 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ư các 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 năng lượng, phạm vi hoặc mô hình quản lý, nhưng cần có đủ bằng chứng cho thấy có cá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, sau đó liên hệ với trưởng nhóm SIG. Các chính sách về gói thành viên sẽ khác nhau theo từng SSI.

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

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

SIG có mục đích hỗ trợ cộng tác trong công việc được chia sẻ. Do đó, SIG sẽ:

  • Không phải là diễn đàn hỗ trợ: danh sách gửi thư và SIG không phải là cùng một
  • Không yêu cầu ngay lập tức: ban đầu trong vòng đời của một dự án, bạn có thể không biết bạn đã chia sẻ công việc hoặc cộng tác viên hay chưa
  • Không phải lao động tự do: cần có năng lượng để phát triển và điều phối công việc cùng nhau

Chủ sở hữu Bazel áp dụng phương pháp thận trọng để 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 có thể xảy ra 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ư nêu rõ bên dưới. Sau đây là một số cách mà bạn có thể xem xét:

  • Một vấn đề được xác định rõ hoặc tập hợp các vấn đề mà nhóm sẽ giải quyết
  • Tư vấn cho các thành viên trong cộng đồng sẽ 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à quan hệ công chúng mà những người đóng góp quan tâm về chủ đề
  • Các mục tiêu tiềm năng để nhóm đạt được
  • Yêu cầu về tài nguyên để chạy nhóm

Ngay cả khi nhu cầu về SIG là điều hiển nhiên, thì việc 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 sẽ tuân theo quy trình bên dưới để điều chỉnh. Cụ thể, tệp này phải chứng minh:

  • Mục đích và lợi ích rõ ràng đối với Bazel (đối với một dự án phụ hoặc khu 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 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-Thảo luận, 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 ban đầu yêu cầ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 các 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ữ của riêng chúng trong tổ chức GitHub bazelbuild. SIG có thể liên kết đến 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 các ứng dụng SIG và tham khảo ý kiến của các bên liên quan khác khi cần

Trước khi nhập 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, theo địa chỉ 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 được thực hiện bằng cách gửi điều lệ cho bộ phận 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. Khi được chấp thuận, PR cho nhóm được hợp nhất và các tài nguyên bắt buộc đã được tạo.

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

Để yêu cầu 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

Để thiết lập một nhóm, bạn cần có một điều lệ và phải tuân theo 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ể mở cho tất cả mọi người mà không cần phê duyệt hoặc có thể theo yêu cầu mà quản trị viên nhóm cần phê duyệt.

Điều lệ phải chỉ định một quản trị viên. Là quản trị viên, nhóm phải bao gồm í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 là đầu mối liên hệ để điều phối theo yêu cầu của 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 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 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 cách 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 phải được quảng cáo trong 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 định kỳ giúp thúc đẩy trách nhiệm giải trình và tiến trình 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à đưa ra biện pháp xử lý khi thích hợp.

Chạy SIG

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

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

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

Sức khỏe và chấm dứt SIG

Chủ sở hữu Bazel luôn cố gắng hết sức để đảm bảo sức khỏe cho 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 rãi về hoạt động của nhóm.

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

Lưu ý

Nội dung này đã được áp dụng từ cẩm nang SIG của Tensorflow qua những lần sửa đổi.