Bileşen Adlandırmasına İlişkin Kısa bir Kılavuz
İsmail Arılık, Yazılım Mühendisi tarafından
1. Anlaşılırlık Anahtardır
Bir bileşenin adı onu tanımlar, bu sebeple anlaşılır olmalıdır. Bir yaklaşım, bileşenin kullanıcı arayüzünde yer alan öğeleri kullanmaktır.
Kullanıcı adı ve şifre girildikten sonra giriş yapmaya yarayan bir tuşunuz mu var? Buna "tuşGiriş" deyin. Peki ya yapılacaklar listesine ekleme yapılmadan önce açılan bir modal? "modalYeniYapılacak" nasıl? Böylece bir koda baktığınızda onun ne anlama geldiğini daha kısa sürede anlayabilecek ve zamandan tasarruf edeceksiniz.
2. Aramalarda Üst Sıralarda Yer Alın
Çok sayıda işbirlikçinin bulunduğu büyük depolarla çalışırken, bileşeninizin insanlar herhangi bir şey aradığında üst sıralarda yer alması önemlidir.
Dikkat çekmenin bir yolu, bileşeninizin üst verisine ilgili anahtar kelimeleri eklemektir. Bu kelimeleri bileşeninizin isminde kullanmayı düşünebilirsiniz ancak bu iyi bir fikir değildir; bileşen isimleri kolayca okunup anlaşılabilir olmalıdır.
3. Dilleri Karıştırmayın
İsimlendirmelerinizde kullanacağınız dili ekip olarak en başta kararlaştırın ve bu karara sadık kalın. Eğer Türkçe’de karar kıldıysanız, her yerde Türkçe kullanın. İngilizce’de karar kıldıysanız, her yerde İngilizce kullanın.
Yazılım projelerindeki isimlendirmelerde İngilizce kullanmak yaygın bir uygulamadır. Ancak, yerel bir uygulama üzerinde herkesin Türkçe konuştuğu bir ekiple çalışıyorsanız, Türkçe kullanmak da iyi bir fikir olabilir. Böylece ekip üyeleri kodu daha kolay anlayabilir.
