Öncelikle Bazel ekosistemine katkıda bulunduğunuz için teşekkür ederiz. Projenizi ve önerilen adını paylaşmak için lütfen bazel-discuss posta listesinden Bazel topluluğuyla iletişime geçin.
Bazel ile ilgili bir araç geliştiriyorsanız veya Skylark kurallarınızı paylaşıyorsanız projenizin adıyla ilgili şu yönergeleri uygulamanızı öneririz:
Starlark kurallarını adlandırma
Dokümanlardaki Yeni Starlark kurallarını dağıtma bölümüne bakın.
Bazel ile ilgili diğer araçları adlandırma
Bu bölüm, Bazel ekosistemini zenginleştirecek bir araç geliştiriyorsanız geçerlidir. Örneğin, yeni bir IDE eklentisi veya yeni bir derleme sistemi taşıyıcısı.
Aracınız için iyi bir ad seçmek zor olabilir. Dikkatli olmaz ve çok fazla kod adı kullanırsak Bazel ekosisteminin yeni gelenler tarafından anlaşılması çok zor olabilir.
Bazel araçlarını adlandırırken aşağıdaki kurallara uyun:
Yeni bir marka adı sunmamayı tercih edin: "Bazel" zaten kullanıcılarımız için yeni bir marka. Çok fazla yeni adla kafalarını karıştırmamalıyız.
"Bazel" kelimesini içeren bir ad kullanmayı tercih edin: Bu, aracın Bazel ile ilgili olduğunu ifade etmeye yardımcı olur ve kullanıcıların arama motoruyla bulmasını kolaylaştırır.
Aracın ne yaptığıyla ilgili açıklayıcı adlar kullanmayı tercih edin: İdeal olarak, kullanıcıların aracın ne yaptığına dair ilk tahminde bulunabilmesi için adın alt başlığa ihtiyacı olmamalıdır. Boşluklarla ayrılmış İngilizce kelimeler kullanmak bu amaç için iyi bir yöntemdir.
Çiçek veya yemek teması kullanmak zorunlu değildir: Bazel, fesleğen bitkisini çağrıştırır. Bitki, yiyecek veya "fesleğen" ile ilgili bir ad aramanıza gerek yoktur.
Aracınız başka bir üçüncü taraf markayla ilgiliyse bunu yalnızca açıklama olarak kullanın: Örneğin, "Cmake Bazel migrator" yerine "Cmake için Bazel taşıyıcı" ifadesini kullanın.
Bu yönergeler, GitHub depo URL'si için de geçerlidir. Depo URL'sini okumak, kullanıcıların aracın ne işe yaradığını anlamasına yardımcı olur. Elbette, depo adı daha kısa olabilir ve boşluk yerine kısa çizgi, küçük harf kullanmalıdır.
İyi ad örnekleri:
- Bazel for Eclipse: Kullanıcılar, Bazel'i Eclipse ile kullanmak istiyorlarsa bu sayfayı ziyaret etmeleri gerektiğini anlayacak. Açıklama olarak üçüncü taraf bir marka kullanılır.
- Bazel buildfarm: "Buildfarm" bir derleme çiftliğidir. Kullanıcılar bu projenin sunucular üzerinde geliştirme ile ilgili olduğunu anlayacak.
Kaçınılması gereken ad örnekleri:
- Ocimum: Fesleğenin bilimsel adı, Bazel projesiyle yeterince alakalı değil.
- Bazelizer: Bu adın arkasındaki araç birçok şey yapabilir ancak bu ad yeterince açıklayıcı değil.
Bu önerilerin, Google'ın bir projeyi açık kaynaklı hale getirirken kullandığı yönergelerle uyumlu olduğunu unutmayın.