Kodu yorum içerisine alarak devreden çıkarmayın

Bir kod parçasının çalışmasını artık istemiyorsanız, en iyi yöntem onu silmektir. Bazı yazılımcılar, artık çalışmasını istemedikleri bu kod parçasını aşağıdaki şekilde yorum içerisine alıyorlar. Çoğu zaman bunun sebebi, o kod parçasını kaybetmekten korkmak oluyor. Halbuki bir versiyon kontrol sistemi (örneğin git) kullanıyorsanız, o kod parçasına her zaman ulaşabilirsiniz. Versiyon kontrol sistemleriyle bir kodu geri getirebilme […]

Yorumun kalitesi, kodun kalitesi kadar önemlidir

Yazılımcılar olarak ürettiklerimizle gurur duymak bizim için bu işin getirdiği ek faydalardan biri. Ne de olsa hiç yoktan yeni bir şey yaratıyoruz ve bu yarattığımız şeyin çalıştığına tanık oluyoruz. Bundan daha keyifli ne olabilir ki? Ürettiklerimize ek olarak, nasıl ürettiğimizin de önemi var. Hele ki yazdığımız kodun oldukça şık ve zarif olduğunu düşünüyorsak, yarattığımız somut […]

Geçersiz yorumlar en baştan zarar

Kodu açıklamak için yazılan herhangi bir yorumun zamanla geçersiz olması oldukça olasıdır. Zaten bu yüzden kod içerisine az ve öz yorum yazmak sanat yapmaya benzer. Zamanla geçersiz olabilecek yorumları önceden kestirip hiç yazmamaksa, öğrenilebilecek bir refleks gibidir. Yazılan her yorum, açıklamaya çalıştığı kodun bakımı için harcanan zaman kadar bakım ister. Bu da aslında kod yorumlarını […]

Kod kendini anlatmalı, yorumlar değil

Yazılım kariyerim boyunca birçok farklı geliştirici ile çalıştım, belki de hepsinin kendine özgü bir kod yorum tarzı vardı. Kimisi hiç yorum yazmazdı, kimisi ise tek satır kod için beş satır yorum yazardı. Ben de bu gam içerisinde değişe değişe kendi tarzımı oluşturdum. Bugün geldiğim nokta benim için hâlâ bir son durak sayılmaz; fakat belli bir […]