Bazel Bakımı Kılavuzları

. Sorun bildirin Kaynağı göster Gece · 7,3 · 7,2 · 7,1 · 7,0 · 6,5

Bu kılavuz, Bazel açık kaynak projesinin geliştiricileri için hazırlanmıştır.

Bazel'a katkıda bulunmak istiyorsanız lütfen şu makaleyi okuyun: Bazel'i seçin.

Bu sayfanın hedefleri şunlardır:

  1. İşveren olarak görev yap projenin katkısıyla ilgili doğru kaynak bahsedeceğim.
  2. Topluluğa katkıda bulunan kişiler ve proje arasında beklentileri belirlemek sorumlular.

Bazel'in temel katkıda bulunanlar grubu, açık kaynak projesinin çeşitli yönlerini yönetmelerine yardımcı olur. Desteklenen biçimler şunlardır:

  • Yayınlama İşlemi: Bazel'ın sürüm sürecini yönetin.
  • Yeşil Ekip: Kurallar ve araçlardan oluşan sağlıklı bir ekosistem oluşturun.
  • Geliştirici Deneyimi Bahçıvanları: Harici katkıları teşvik edin, inceleyin ve pull isteklerinden bahsedeceğiz. Ayrıca, geliştirme iş akışımızı daha açık hale getirebileceğimizi düşünüyoruz.

Sürümler

Sürekli Entegrasyon

Yeşil ekip için Bazel'in CI altyapısı hakkındaki rehberi bazelbuild/continuous-integration depodur.

Bir Sorunun Yaşam Döngüsü

  1. Kullanıcı, sorun şablonları ve incelenmemiş açık sorunları hakkında daha fazla bilgi edinin.
  2. Geliştirici Deneyimi (DevEx) alt ekibi rotasyonunun bir üyesi, .
    1. Sorun bir hata veya özellik isteği değilse DevEx üyesi genellikle sorunu kapatır ve kullanıcıyı StackOverflow ve bazel-caption görünür hale getirebilirsiniz.
    2. Sorun, rules_apple gibi, DevEx üyesi bu sorunu aktarır gönderir.
    3. Sorun muğlaksa veya eksik bilgiler varsa DevEx üyesi daha fazla bilgi istemek için sorunu kullanıcıya geri atayın devam ediyor. Bu genellikle kullanıcı doğru reklam öğesini seçmediğinde sorun şablonu {: .external} gibi görünen ya da eksik bilgi veren içerikler.
  3. DevEx üyesi sorunu inceledikten sonra, sorunun gerekli olup olmadığına karar verir. . Roller aynıysa P0'ı atarlar. öncelik etiketi ve ekip potansiyel müşterileri listesinden bir sahip.
  4. DevEx üyesi, untriaged etiketini ve tam olarak bir ekip atar. etiket ekleyin.
  5. DevEx üyesi ayrıca type: bug gibi tam bir type: etiketi atar veya type: feature request seçeneğini belirtin.
  6. DevEx üyesi, platforma özgü sorunlar için bir platform: etiketi atar. örneğin, Mac'e özgü sorunlar için platform:apple gibi.
  7. Sorun düşük önceliğe sahipse ve yeni bir topluluk tarafından üzerinde çalışılabilirse good first issue etiketini DevEx üyesi atar. Bu aşamada sorun, Önceliklendirilmemiş açık alanlar havuzuna girer. sorunları hakkında daha fazla bilgi edinin.

Her Bazel alt ekibi, tüm sorunları sahip oldukları etiketler altında, tercihen haftalık bazda. Alt ekip sorunu inceleyip değerlendirir ve bir çözüm bulmanız gerekir. Bir ekip etiketinin sahibiyseniz bu bölüme bakın başlıklı makaleyi okuyabilirsiniz.

Bir sorun çözüldüğünde kapatılabilir.

Push İsteğinin Yaşam Döngüsü

  1. Bir kullanıcı, bir pull isteği oluşturur.
  2. Bir Bazel ekibinin üyesiyseniz ve kendi bölgenizle ilgili halkla ilişkiler gönderiyorsanız ekip etiketinizi atamak ve en iyi uygulamaları bulmaktan sorumlusunuz. incelemecidir.
  3. Aksi takdirde, günlük öncelik belirleme sırasında bir DevEx üyesi, ekip etiketi ve yönlendirme için ekibin teknik lideri (TL).
    1. TL, isteğe bağlı olarak halkla ilişkiler incelemesi için başka birini atayabilir.
  4. Atanan yorumcu PR'yi inceler ve belirlenene kadar yazarla birlikte çalışır. olduğunu görebilirsiniz.
  5. İncelemeci, onaylanırsa Halkla İlişkiler'in taahhütlerini Google'ın dahili sürüm kontrol sistemini kullanıma sunduk. Bazel aynı yapıda olduğu için, kullandığımız tüm halkla ilişkiler (PR) taahhütlerini dahili test paketinden yararlanın. Bu nedenle halkla ilişkiler departmanını doğrudan birleştirmemekteyiz.
  6. İçe aktarılan kayıt tüm dahili testleri geçerse kayıt sıkıştırılır ve GitHub'a geri aktarılır.
  7. Kayıt ana kopyayla birleştiğinde GitHub, PR'yi otomatik olarak kapatır.

Ekibimin bir plak şirketi var. Ne yapmalıyım?

Alt ekiplerin sahip oldukları etiketlerde tüm sorunları önceliklendirmesi gerekir. haftalık olarak düzenlenecek.

Sorunlar

  1. Sorun listesini ekip etiketinize ve untriaged etiketine göre filtreleyin.
  2. Sorunu inceleyin.
  3. Bir öncelik düzeyi belirleyin ve etiketi atayın.
    1. Sorun daha önce DevEx alt ekibi tarafından önceliklendirilmiş olabilir. S0. Gerekirse yeniden öncelik sırasına koyun.
    2. Her sorunun tam olarak bir öncelik etiketine sahip olması gerekir. Bir P0 ya da P1 olduğunu varsayıyoruz. Bunun etkin bir şekilde üzerinde çalışıldığını varsayıyoruz.
  4. untriaged etiketini kaldırın.

Uygulamanızın, yeni bir sürüm oluşturmak için bazelbuild kuruluşuna giderek etiket ekleyin veya kaldırın.

Push İstekleri

  1. Push istekleri listesini ekip etiketinize göre filtreleyin.
  2. Açık pull isteklerini inceleyin.
    1. İsteğe bağlı: İnceleme için atandıysanız ancak sizin için uygun değilseniz kod incelemesi yapması için uygun incelemeciyi tekrar atayın.
  3. Kod incelemesini tamamlamak için pull isteğini oluşturan kişiyle birlikte çalışın.
  4. PR'yi onaylayın.
  5. Tüm testlerin başarılı olduğundan emin olmak.
  6. Yamayı dahili sürüm kontrol sistemine aktarın ve dahili sayısı.
  7. Dahili yamayı gönderin. Yama başarıyla gönderilir ve dışa aktarılırsa PR GitHub tarafından otomatik olarak kapatılacak.

Öncelik

Öncelik için aşağıdaki tanımlar, öncelik belirlemek için bakımcılar tarafından kullanılacaktır sorunları.

  • P0: Önemli düzeyde bozuk bir Bazel sürümünün (yayınlama adayları çıkarılarak) kullanılmasına neden olan işlevsellik kullanılamaz veya Bazel'in gelişimini ciddi şekilde etkileyen kullanımdan kaldırılmış bir hizmet belirler. Buna yeni bir sürümde eklenen ve bir veya zarar veren bir değişiklik ya da İş Kırılım Yapısı'na uygun Değiştir politikası. Pratik bir çözüm yok.
  • P1: Kritik kusur veya veya gelecek sürümde ele alınması gereken ciddi bir sorun ya da birçok kullanıcıyı etkiler (Bazel projesinin geliştirilmesi dahil), ancak bunun pratik bir çözümü olduğu düşünülebilir. Genellikle hemen işlem yapılması gerekmez. İçinde mevcut üç aylık dönemlerin yol haritasında planlanmış olmalı.
  • P2: Kusur veya özellik ancak şu anda üzerinde çalışmamız gereken bir problem var. Orta düzey yayın sorunu uygulanması gereken kullanıcı açısından elverişsiz bir şekilde, yayınlanmış Bazel sürümünde ve/veya kolay bir geçici çözüm mevcut.
  • P3 - İstenen küçük hata küçük etkiyle düzeltme veya geliştirme yapar. Bazel yol haritalarında veya Ancak yakın zamanda tüm içerikler yayınlanır ancak topluluk katkıları önerilir.
  • P4: Düşük öncelikli kusur kapatılma olasılığı düşük olan bir özellik veya özellik isteği gönderin. Bir süre açık tutulabilir daha fazla kullanıcının yeniden önceliklendirilmesi ihtimalini artırır.
  • buz kutusu
    • Şu anda çözmek için vaktimiz olmayan sorunlar kabul etmeniz gerekir. Daha önce belirtilen şekilde ihlal edildiğini belirtmek için bu bu metinlerin üzerinde kimse çalışmamaktadır, ancak zaman içinde ve yeterli sayıda insan etkilendiği takdirde bu felaketleri hayata geçirmemizi kaynaklar olduğunu varsayalım. Her zamanki gibi yorum veya tepki ekleyebilirsiniz bu sorunlara değineceğiz.

Ekip etiketleri

Yeni sorunlarda category: * etiketlerinin desteğini, ekibin lehine sonlandırdık etiketler.

Etiketlerin tam listesini burada bulabilirsiniz.