TRL documentation
Deneysel
Deneysel
Bu dizin, yeni fikirler üzerinde hızlı iterasyon için minimal ve net bir şekilde ayrılmış bir alan içerir.
Stabilite sözleşmesi:
trl.experimentalaltındaki her şey, önceden bir sona erdirme bildirimi yapılmaksızın herhangi bir sürümde (yama sürümleri dahil) değiştirilebilir veya kaldırılabilir. Bu API'lere üretim iş yükleri için güvenmeyin.
Yükselme Yolu (Basit)
- Ana depoyun dışında prototiple: Hızlıca tekrarlayabilmek için geliştirmeye kendi fork'unuzda veya ayrı bir depoda başlayın.
- Deneysel dahil etme: Erken kullanıcılar için hazır olduğunda, fikri
trl.experimental.<feature>içine taşıyın. - İyileştirme: Testler, kısa bir doküman/örnek ekleyin ve kullanımı gösterin.
- Promote: API'nin kararlı olduğu ve topluluktan net bir ilgi veya kullanım olduğu kanıtlandığında, onu
trl.<feature>(kararlı modül) içine taşıyın.
Kaldırma
Experimental bir geçici alan, uzun vadeli depolama alanı değildir: bir özellik ya yükseltilir ya da kaldırılır. Yukarıdaki kararlılık sözleşmesinde belirtildiği üzere, kaldırma işlemi için bir terk etme döngüsü gerekmez. Kod, git geçmişinde erişilebilir kalmaya devam eder ve makale dizini girişi, uygulamanın son sürümünü içeren son sürüme işaret edecek şekilde yerinde kalır.
Eşik değeri tetikleyen bir kaldırma işlemi yoktur. Bu, kaldırma çekme isteğinde, herkesin önünde sayılarla birlikte yapılan bir yargılamadır. Bu yargılamanın değerlendirdiği hususlar:
- Kullanım. Telemetri, Hub etiketleri ve çekme isteğindeki veya tartışma başlığındaki yanıtlar. Bunların hiçbiri tek başına kesin bir kanıt oluşturmaz, ancak hepsinin sessiz olması güçlü bir işarettir.
- Kod taramasıyla üretilen raporların aksine, özelliğin çalıştırılmasından kaynaklanan dış sorunlar ve çekme istekleri.
- Kararlı bir eğitimcinin bunu zaten kapsayıp kapsamadığı. Kapsıyorsa, bu kullanım sıklığından daha belirleyicidir.
- Maliyet. CI süresi, bakım, triyaj yükü.
- Aşağı akış tüketicileri. Bunu içe aktaran kütüphaneler.
- Sahip. Tanıtımını yapmak isteyen ve bu iş için çalışmaya hazır olan kişi.
- Yaş. Topluluğun bulup denemesi için yeterince uzun süredir mevcut olup olmadığı.
SSS
Neden sadece dallar kullanılmıyor? Çünkü dallar kullanıcılara dağıtılmaz; paket içindeki deneysel kod, erken benimseyenlerin denemeler yapmasına ve geri bildirim vermesine olanak tanır.
Bu API'ler uyarı vermeden değişebilir veya kaldırılabilir mi? Evet. trl.experimental içindeki her şey herhangi bir sürümde değişebilir veya kaldırılabilir.
Bunu üretim ortamında kullanmalı mıyım? Değişiklikler olduğunda kodunuzu hızla güncelleyebilecekseniz kullanabilirsiniz.
Bakımcılar trl.experimental içindeki sorunları derhal düzeltecek mi? Zorunlu değil. Deneysel modül, yeni fikirler için bir çalışma alanıdır ve bakımcılar oradaki hata düzeltmelerine veya özellik taleplerine öncelik vermeyebilir. Özellik kararlı API'ye taşınana kadar (veya taşınmadığı takdirde) sorunlar çözümsüz kalabilir.
Kağıt uygulaması katkısı yaptım. Kaldırılabilir mi? Evet. trl.experimental altındaki her şey, kağıt uygulamaları dahil, kaldırılabilir. Bu gerçekleşirse, kağıt dizini girişi kalır ve kodu içeren son sürüme işaret eder.
Çalışma zamanı bildirimi nasıl susturulur?
Kullanım: export TRL_EXPERIMENTAL_SILENCE=1.