
commentle ama aşırı da commentleme


Hemen hemen her programlama dili için bulabileceğin kılavuzlar var, "programlama dili + style guide" diye aratabilirsin. Bence burada önemli olan iki şey var; o yapının sana uygun olması ve yaygın kullanılıyor olması gerek.
JavaScript için bir örnek vereyim.
github.com


(bkz: coding convention)
coding convention, genelde şirket veya proje bazlı oluşturulur. bir işe başlamadan önce coding convention ile farklı kişiler tarafından yazılan kodların değişken ve fonksiyonların dahi aynı stil ve düzende olması planlanır.


bu programlama diline göre de değişkenlik gösterebilir ancak yine de genel geçer kurallar yazılabilir.


Genel gecer kuraldan ziyade, makinenin degil insanin anlayabilecegi (ki zor olan bu) sekilde, "temiz" kod yazmak istiyorsan mutlaka okuman gereken kitap -> Robert C Martin'in Clean Code kitabi.
Onun disinda arkadaslarin dedigi gibi programlama dili / sirket kulturu ozelinde styling guide'lari uygulayabilirsin github.com
