Yeni bir özellik önermek

BeeWare için yeni özellikler veya belgelerle ilgili öneri ve fikirlere her zaman açığız. Peki, fikrinizi değerlendirilmek üzere nasıl gönderebilirsiniz?

Başlamadan önce

Uygulamak istediğimiz çok uzun bir özellik listemiz var, ancak kaynaklarımız çok sınırlı. BeeWare'yi daha iyi hale getirebilecek bir fikriniz varsa, bunu duymaktan memnuniyet duyarız. Yeterli sayıda kişi aynı şeyi talep ederse, çekirdek ekip bu fikri uygulayabilir. Ancak, tek başına bir özellik talebinde bulunmak, bu özelliğin yakın gelecekte uygulanmasına yol açmayabilir.

BeeWare bir Açık Kaynak topluluğudur. Bir özelliğin uygulanmasını sağlamanın en etkili yolu, onu kendiniz uygulamaktır. Katkıda bulunanların eklemek istedikleri özellikleri uygulamalarına yardımcı olmak için elimizden geleni yapacağız. Çekirdek ekibin sizin için bir özelliği ücretsiz olarak uygulaması talepleri, pek hoş karşılanmayacaktır.

Bir özelliği kendiniz uygulayamıyorsanız, özelliğin geliştirilmesini hızlandırmanın diğer bir yolu, bunu sizin için uygulaması için birine ödeme yapmaktır. Belirli bir özelliğin geliştirilmesinin önceliklendirilmesi için ödeme yapmayı görüşmek isterseniz, lütfen BeeWare ekibiyle iletişime geçin.

Yeni işlevler önermek

Önerilebilecek en bariz şey, yeni bir API veya özellik. BeeWare'nin şu anda desteklemediği bir kullanım durumunuz varsa veya BeeWare'nin şu anda kullanamadığı bir yerel platform özelliği varsa, bu boşluğu gidermek için bir değişiklik önermek isteyebilirsiniz.

Yeni bir özellik önerirken, BeeWare araç setinin birden fazla platformu desteklediğini unutmayın. Bu, yeni özelliklerin aşağıdaki şartları sağlaması gerektiği anlamına gelir:

• Tüm platformlarda uygun ve uygulanabilir olmalıdır (örneğin, her GUI araç setinde "düğme" kavramı vardır); veya
• Aynı "tür" platformlar için uygun olmalı ve diğer platformlarda göz ardı edilebilir olmalıdır (örneğin, tüm cep telefonlarında ivmeölçer bulunurken, masaüstü bilgisayarlarda pek bulunmaz; bu nedenle, iOS ve Android için bir ivmeölçer API'sının olması mantıklıdır, ancak masaüstü veya web platformları için olması mantıklı değildir); veya
• Genel API'yi değiştirmeden dahili platform özelliğine erişim izni verin (örneğin, açıkça Android'e özgü bir özellik ekleyemezsiniz, ancak son kullanıcıların kendi kodlarından Android'e özgü bir özelliğe daha kolay erişmesini sağlayabilirsiniz).

Bu, her platformda bir özelliği uygulamaktan sorumlu olmanız gerektiği anlamına gelmez. Apple donanımına erişiminiz yoksa, bir özelliğin macOS veya iOS uygulamasını sağlamanızı beklemek mantıklı olmaz. Ancak, tasarım sürecinin bir parçası olarak, bir özelliği tarif ettiğiniz şekilde uygulamanın mümkün olduğunu belirlememiz gerekir.

Yeni dokümantasyon önermek

Önermek isteyebileceğiniz bir diğer konu da belgelerin iyileştirilmesidir. BeeWare belgelerinin iyileştirilmesi için bir fikriniz varsa, dikkate alınması gereken hususlar şunlardır:

• Öneriniz mevcut belgelerle çakışıyor mu? Yeni bir kılavuz mu öneriyorsunuz, yoksa mevcut bir kılavuza ek mi öneriyorsunuz?
• BeeWare ekosisteminin geri kalanına nasıl uyuyor? Bu proje, fikri belgelemek için doğru yer mi? Yoksa başka bir projede bir özelliği belgelemeli ve o belgeye bağlantı vermeli miyiz?
• Belirli talimatların anlamlı hale gelmesi için öncelikle açıklanması gereken üst düzey bir kavram var mı?
• Bu konuyu açıklamamız mantıklı mı, yoksa başka biri bu konuyu daha önce ele almış ve biz de ona başvurabilir miyiz?

Bunlardan herhangi birinden emin değilseniz endişelenmeyin! Fikrinizi gönderin ve ilk görüşmede emin olmadığınız noktaları bize bildirin, biz de fikirlerinizi BeeWare belgelerine uygun bir forma dönüştürmenize yardımcı olalım.

Özellik önerisi sunmak

Yeni bir özellik önermek

BeeWare için bir iyileştirme fikriniz var - bu fikri değerlendirilmek üzere nasıl sunabilirsiniz?

Araştırmanızı yapın

İlk adım, BeeWare sorun izleyicisinde mevcut özellik sorunları ("geliştirme" etiketli sorunlar), belgeleme sorunları ("belgeleme" etiketli sorunlar) veya Tartışma konuları arayarak bu fikrin daha önce önerilip önerilmediğini kontrol etmektir. Önerilmişse ve eklemek istediğiniz yeni bir bağlam veya fikir varsa, bunları mevcut konuya ekleyin. Araştırmanızda yardıma ihtiyacınız varsa, BeeWare Discord üzerindeki #dev kanalında soru sorabilirsiniz. Size mevcut konuları gösterebilir, bilmediğiniz bağlamları sağlayabilir veya fikrinizi ilk bakışta alakalı görünmeyen başka bir fikirle ilişkilendirebiliriz.

Fikri tartışın

Fikrinizle ilgili mevcut herhangi bir referans bulamazsanız, bir Tartışma başlığı açın. Fikrinizin amacını ve kullanım örneğini genel hatlarıyla açıklayın. Özelliğin uygulanması durumunda nasıl görüneceğine dair düşüncelerinizi de ekleyin. Örneğin, API'nin genel şekli, özelliğin görsel görünümü veya eklenecek belge gibi. Uygunsa, fikrinizin farklı platformlarda nasıl ortaya çıkacağına dair yaptığınız araştırmaları da eklemelisiniz.

Tartışma başlığı açıldığında, BeeWare ekibi ve topluluğun geri kalanı yanıt verecektir. Çekirdek ekip, iki iş günü içinde fikriniz hakkında en azından ilk izlenimlerini paylaşmayı hedefleyecektir. Bir fikir özellikle karmaşıksa, daha ayrıntılı bir analiz bir haftaya kadar sürebilir. Tatiller ve konferanslar gibi olaylar bu sürelerin biraz daha uzamasına neden olabilir.

Bu, fikriniz hakkında bir sohbete katılma fırsatınızdır. Daha fazla ayrıntı veya bağlam isteyebiliriz. Topluluğun diğer üyeleri de tartışmaya katılarak farklı bakış açıları, öneriler veya karşı öneriler sunabilir. Bu tartışmanın sonucu, sonraki adımları belirleyecektir.

Tüm fikirlerin kabul edilmeyeceğini anlamak önemlidir. Bu sürecin bir teklifle başlamasının nedeni, tüm işi yapıp sonra da değişikliğinizin kabul edilmeyecek bir nedeni olduğunu öğrenmenizi önlemektir.

Bu, bunun iyi bir fikir olmadığı anlamına gelmez! Uygulanamamasının teknik nedenleri olabilir. Örneğin, aşağıdaki durumlarda bir fikri reddedebiliriz:

• Desteklenen tüm platformlarda güvenilir bir şekilde uygulanması zor veya imkansız olacaktır; veya
• Bakımı zor olacaktır veya bakım için yaygın olarak bulunmayan teknoloji veya yazılıma erişim gerekecektir; veya
• Niş bir kitleye hizmet ediyor, ancak diğer kullanıcılara önemli bir ek yük getiriyor.

Fikrinizin uygun olmadığına karar verirsek, bu mutlaka fikrinizden vazgeçmeniz gerektiği anlamına gelmez. Belirli bir fikri reddedebiliriz, ancak aynı özelliği harici bir kütüphane olarak sürdürmenizi sağlayacak bir eklenti arayüzü veya başka bir uzantı noktası eklemeye çok daha açık olabiliriz. Bu şekilde, özelliği elde edebilir, ancak özelliğin belirli bakım sorunları veya sınırlamaları projenin kendisi için bir kısıtlama haline gelmez.

Resmi özellik talebine dönüştür

Tartışma, bir özelliğin şekli konusunda bir konsensüse ulaştığında, beeware sorun izleyicisinde, tartışmayı özetleyen ve bağlam için tartışmaya bağlantı veren yeni bir özellik isteği sorunu oluşturabilirsiniz.

Özellik önerinizi kendiniz uygulamak zorunda değilsiniz; önerdiğiniz şeyin ayrıntılarını içeren bir sorun bildirimi açabilirsiniz. Ancak, sorunu bildirmekle, bunun sizin için uygulanacağı anlamına gelmez. Aynı özellikle ilgilenen başka bir kişi, ister başka bir topluluk üyesi ister çekirdek ekip olsun, bu sorunu ele almasını beklemeniz gerekir; ancak bunun gerçekleşeceği garanti edilemez. Uygulamanın garanti edilmesini istiyorsanız, bunu kendiniz uygulamalı veya başkasına uygulatmak için ödeme yapmalısınız.