Bazel, işbirliğini belirli alanlara odaklamak ve Bazel sahipleri, bakımcıları ve katkıda bulunanlar arasındaki iletişimi ve koordinasyonu desteklemek için Özel İlgi Alanı Grupları (SIG) barındırır. Bu politika, bazelbuild için geçerlidir.
ÖİG'ler çalışmalarını herkese açık olarak yapar. Özel ilgi alanları grubu için ideal kapsam, katılımın çoğunlukla topluluktan geldiği, iyi tanımlanmış bir alanı kapsar. SIG'ler, bazelbuild'daki topluluk tarafından yönetilen depolar (ör. dil kuralları) veya Bazel deposundaki kod alanları (ör. uzaktan yürütme) üzerinde odaklanabilir.
Tüm özel ilgi grupları aynı enerji düzeyine, kapsam genişliğine veya yönetim modellerine sahip olmasa da ilgi grubu oluşturulursa topluluk üyelerinin etkileşime girmeye ve katkıda bulunmaya istekli olduğuna dair yeterli kanıt olmalıdır. Katılmadan önce grubun çalışmalarını inceleyin ve ardından SIG lideriyle iletişime geçin. Üyelik politikaları, SIG'ye göre değişir.
Bazel SIG'lerinin tam listesini inceleyin.
Hedef dışı konular: Çalışma grubunun kapsamı dışında kalanlar
ÖGG'ler, ortak çalışmalar üzerinde iş birliğini kolaylaştırmak için tasarlanmıştır. Bu nedenle, SIG şunları içerir:
- Destek forumu değildir: Posta listesi ve SIG aynı şey değildir
- Hemen gerekli değildir: Bir projenin başlangıcında, paylaşılan işiniz veya ortak çalışanlarınız olup olmadığını bilmiyor olabilirsiniz.
- Ücretsiz emek değildir: Birlikte çalışarak büyümek ve işi koordine etmek için enerji gerekir.
Bazel sahipleri, SIG oluşturma konusunda muhafazakar bir yaklaşım sergiliyor. GitHub'da proje başlatmanın kolaylığı sayesinde, SIG'ye ihtiyaç duymadan ortak çalışma yapılabilecek birçok yol var.
SIG yaşam döngüsü
Bu bölümde, SIG'lerin nasıl oluşturulacağı açıklanmaktadır.
Araştırma ve danışma
Yeni bir SIG grubu önermek için önce aşağıda belirtildiği gibi onay kanıtı toplayın. Göz önünde bulundurabileceğiniz bazı olası yollar:
- Grubun çözeceği iyi tanımlanmış bir sorun veya sorunlar
- Avantajlardan yararlanacak topluluk üyeleriyle görüşme yaparak hem avantajı hem de taahhütte bulunma isteklerini değerlendirme
- Mevcut projelerde, katkıda bulunanların konuyla ilgilendiğini gösteren sorunlar ve PR'lerden elde edilen kanıtlar
- Grubun ulaşabileceği potansiyel hedefler
- Grubu çalıştırmak için gereken kaynaklar
Özel ilgi alanları grubu oluşturma ihtiyacı açıkça görülse bile grubun başarısı için araştırma ve danışma önemlidir.
Yeni grubu oluşturma
Yeni grup, tüzük oluşturma için aşağıdaki süreci izlemelidir. Özellikle, şunları göstermelidir:
- Bazel'in net bir amacı ve avantajı (alt proje veya uygulama alanı ile ilgili)
- Grup yöneticisi olarak hareket etmeye istekli iki veya daha fazla katkıda bulunan, diğer katkıda bulunanların varlığı ve gruba yönelik talebin kanıtı
- Her grubun herkese açık en az bir posta listesi kullanması gerekir. Bir SIG, bazel-discuss gibi herkese açık listelerden birini yeniden kullanabilir, @bazel.build için bir liste isteyebilir veya kendi listesini oluşturabilir.
- SIG'nin başlangıçta ihtiyaç duyduğu kaynaklar (genellikle posta listesi ve düzenli görüntülü görüşme).
- SIG'ler,
bazelbuild/communitydizinindeki veyabazelbuildGitHub kuruluşundaki kendi depolarındaki dokümanları ve dosyaları sunabilir. SIG'ler, çalışmalarınıbazelbuildGitHub kuruluşunun dışında düzenlemeyi tercih ederlerse harici kaynaklara bağlantı verebilir. - Bazel sahipleri, SIG uygulamalarını onaylar veya reddeder ve gerektiğinde diğer paydaşlara danışır.
Sürecin resmi kısımlarına girmeden önce product@bazel.build adresinden Bazel ürün ekibine danışmanız gerekir. Çoğu ÖİG, onaylanmadan önce görüşme ve yineleme gerektirir.
Yeni grup için resmi talep, bazelbuild/community adresine bir tüzük gönderilerek ve aşağıdaki şablonu kullanarak çekme isteğinin çekme ile ilgili yorumlara eklenmesiyle yapılır. Onaylandıktan sonra grubun PR'si birleştirilir ve gerekli kaynaklar oluşturulur.
Yeni SIG için Şablon İsteği
Yeni bir SIG isteğinde bulunmak için topluluk deposundaki şablonu kullanın: SIG-request-template.md.
Kiralama
Grup oluşturmak için tüzüğe ihtiyacınız vardır ve Bazel davranış kurallarına uymanız gerekir. Grubun arşivleri herkese açık olur. Üyelik, onay olmadan herkese açık olabilir veya grup yöneticisinin onayı beklenerek istek üzerine verilebilir.
Tüzükte bir yönetici atanmalıdır. Grubun bir yöneticinin yanı sıra en az bir lideri de olmalıdır (aynı kişi olabilir). Bu kişi, Bazel ürün ekibiyle gerektiği şekilde koordinasyon için irtibat kişisi olarak görev yapar.
Grup oluşturucular, tüzüklerini grubun posta listesinde yayınlamalıdır. Bazel GitHub kuruluşundaki topluluk deposunda bu tür dokümanlar ve politikalar arşivlenir. Gruplar uygulamalarını ve kurallarını geliştirdikçe tüzüklerini topluluk deposunun ilgili bölümünde güncellemeleri gerekir.
Ortak çalışma ve kapsayıcılık
Zorunlu olmasa da grup, toplantıları yapmak için planlanmış konferans görüşmeleri veya sohbet kanalları aracılığıyla işbirliği yapmayı tercih etmelidir. Bu tür toplantılar posta listesinde duyurulmalı ve notlar daha sonra posta listesinde yayınlanmalıdır. Düzenli toplantılar, bir özel ilgi alanında hesap verebilirliği ve ilerlemeyi artırmaya yardımcı olur.
Bazel ürün ekibi üyeleri, grubu proaktif olarak izleyebilir ve uygun şekilde tartışmaya ve harekete geçmeye teşvik edebilir.
Özel ilgi grubu başlatma
Gerekli etkinlikler:
- Notify Bazel general discussion groups (bazel-discuss, bazel-dev).
İsteğe bağlı etkinlikler:
- Bazel blogu için blog yayını oluşturma
SIG'lerin sağlığı ve feshi
Bazel sahipleri, SIG'lerin sağlıklı olmasını sağlamak için gerekli tüm çabayı gösterir. Bazel sahipleri, zaman zaman SIG liderinden SIG'nin çalışmaları hakkında rapor vermesini ve grubun etkinliği hakkında daha geniş Bazel topluluğunu bilgilendirmesini ister.
Bir ÖİG'nin artık faydalı bir amacı veya ilgili bir topluluğu yoksa arşivlenebilir ve faaliyetleri durdurulabilir. Bazel ürün ekibi, projenin genel sağlığını korumak için bu tür etkin olmayan SIG'leri arşivleme hakkını saklı tutar. Bu, daha az tercih edilen bir sonuç olsa da. Bir SIG, faydalı ömrünün sonuna ulaştığını fark ederse dağılmayı da seçebilir.
Not
Bu içerik, Tensorflow'un SIG playbook'undan uyarlanmıştır.