Bazel, ortak çalışmayı belirli alanlara odaklamak ve Bazel sahipleri, koruyucuları ve katkıda bulunanları arasındaki iletişimi ve koordinasyonu desteklemek için Özel İlgi Alanı Grupları'na (SIG'ler) ev sahipliği yapar. Bu politika bazelbuild için geçerlidir.
SIG'ler çalışmalarını herkese açık olarak yapar. Bir SIG'nin ideal kapsamı, katılımın çoğunluğunun topluluktan geldiği iyi tanımlanmış bir alanı kapsar. SIG'ler, bazelbuild'teki topluluk tarafından yönetilen depolara (dil kuralları gibi) veya Bazel deposundaki kod alanlarına (uzak yürütme gibi) odaklanabilir.
Tüm SIG'lerin aynı düzeyde enerjisi, kapsamı veya yönetim modelleri olmasa da ilgi alanı grubu oluşturulduğunda etkileşime geçmek ve katkıda bulunmak isteyen topluluk üyelerinin bulunduğ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.
Hedefler dışında: SIG nedir?
Özel ilgi grupları, paylaşılan çalışmalarda ortak çalışmayı kolaylaştırmak için tasarlanmıştır. Bu nedenle, SIG'ler:
- Destek forumu değildir: Posta listesi ve SIG aynı şey değildir.
- Hemen gerekli değildir: Projenin ilk aşamalarında, paylaşılan çalışma veya ortak çalışan olup olmadığınızı bilmiyor olabilirsiniz.
- Ücretsiz emek değildir: İşi büyütmek ve ortaklaşa koordine etmek için enerji gerekir
Bazel Sahipleri, SIG oluşturma konusunda muhafazakar bir yaklaşım benimser. GitHub'da proje başlatmanın kolaylığı sayesinde, SIG'ye gerek kalmadan ortak çalışmanın yapılabileceği birçok yol vardır.
SIG yaşam döngüsü
Bu bölümde, SIG'lerin nasıl oluşturulacağı ele alınmaktadı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ı yöntemler şunlardır:
- Grubun çözeceği iyi tanımlanmış bir sorun veya sorun grubu
- Hem avantajı hem de bağlılık istekliliklerini değerlendirerek, bu durumdan faydalanabilecek topluluk üyeleriyle istişare
- Mevcut projelerde, katkıda bulunanların konuyla ilgilendiğini gösteren sorunlar ve PR'lerden kanıt
- Grubun ulaşabileceği potansiyel hedefler
- Grubu çalıştırmak için gereken kaynaklar
Bir SIG'ye ihtiyaç olduğu açık olsa bile araştırma ve danışma, grubun başarısı için yine de önemlidir.
Yeni grubu oluşturun
Yeni grup, kuruluş için aşağıdaki süreci izlemelidir. Özellikle şu özellikleri göstermelidir:
- Bazel için net bir amaç ve avantaj (alt proje veya uygulama alanı çevresinde)
- Grup yöneticisi olarak görev yapmak isteyen iki veya daha fazla katkıda bulunan, diğer katkıda bulunanların varlığı ve gruba yönelik talep olduğunu gösteren kanıt
- Her grubun herkese açık en az bir posta listesi kullanması gerekir. SIG'ler, bazel-discuss gibi herkese açık listelerden birini yeniden kullanabilir, @bazel.build için liste isteyebilir veya kendi listelerini oluşturabilir.
- SIG'nin başlangıçta ihtiyaç duyduğu kaynaklar (genellikle posta listesi ve normal görüntülü görüşme).
- SIG'ler,
bazelbuild/communitydizinlerindeki veyabazelbuildGitHub kuruluşundaki kendi depolarındaki dokümanları ve dosyaları yayınlayabilir. ÇalışmalarınıbazelbuildGitHub kuruluşunun dışında düzenlemeyi seçen özel ilgi grupları harici kaynaklara bağlantı verebilir. - Bazel sahipleri, SIG başvurularını onaylar veya reddeder ve gerektiğinde diğer paydaşlara danışır.
Sürecin resmi bölümlerine girmeden önce product@bazel.build adresindeki Bazel ürün ekibine danışmanız gerekir. Çoğu SIG, onaydan önce görüşme ve iterasyon gerektirir.
Yeni grup için resmi istek, bazelbuild/community adresine halkla ilişkiler olarak bir tüzüğü göndererek ve isteği aşağıdaki şablonu izleyerek halkla ilişkilerdeki yorumlara ekleyerek 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üğünüz olmalı 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ı beklenirken istek üzerine kullanılabilir.
Tüzüğünde bir yönetici atanmalıdır. Grupta, yöneticinin yanı sıra Bazel ürün ekibiyle koordinasyon için irtibat noktası olarak görev yapacak en az bir kişi (bu kişi aynı kişi olabilir) bulunmalıdır.
Grup oluşturucular, tüzklerini grup posta listesine göndermelidir. Bazel GitHub kuruluşundaki topluluk deposu bu tür dokümanları ve politikaları arşivler. Gruplar uygulamalarını ve kurallarına göre hareket ettikçe topluluk deposunun ilgili bölümündeki tüzklerini güncellemelidir.
Ortak çalışma ve kapsayıcılık
Zorunlu olmasa da grup, toplantı yapmak için planlanmış konferans görüşmeleri veya sohbet kanalları aracılığıyla ortak çalışmayı tercih etmelidir. Bu tür toplantıların duyurusu posta listesinde yapılmalı ve notlar daha sonra posta listesine gönderilmelidir. Düzenli toplantılar, SIG'de hesap verebilirliği ve ilerlemeyi artırmaya yardımcı olur.
Bazı ürün ekibi üyeleri, grubu proaktif olarak izleyebilir ve uygun durumlarda tartışmaya ve işlem yapmaya teşvik edebilir.
SIG oluşturma
Gerekli etkinlikler:
- Bazel genel tartışma gruplarını (bazel-discuss, bazel-dev) bilgilendirin.
İsteğe bağlı etkinlikler:
- Bazel blogu için blog yayını oluşturma
SIG'lerin durumu ve feshedilmesi
Bazel sahipleri, SIG'lerin sağlıklı kalmasını sağlamak için ellerinden geleni yapar. Bazel sahipleri, Bazel topluluğunu grubun faaliyetleri hakkında bilgilendirmek için Bazel SIG'si liderinden zaman zaman SIG'nin çalışmaları hakkında rapor sunmasını ister.
Bir SIG'nin artık faydalı bir amacı veya ilgilenen bir topluluğu yoksa arşivlenebilir ve faaliyetleri sonlandırılabilir. 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. Ancak bu, tercih edilen bir sonuç değildir. Bir SIG, faydalı kullanım ömrünün sonuna ulaştığını fark ederse de dağılmayı seçebilir.
Not
Bu içerik, TensorFlow'un SIG kılavuzundan değişiklikler yapılarak alınmıştır.