Daha iyi bir geliştirici olmak: Kararlarını açıklayabilmek

Bir kod parçasının çalışması, değerlendirmeyi bitirmez. Aynı davranışı başka bir geliştirici sürdürmek istediğinde, hangi kararların verildiğini ve bunların neye dayandığını da anlaması gerekir.

Sonucu değil, davranışı tarif et

Bir değişikliği “refactor yapıldı” diye anlatmak yerine, neyin hangi durumda farklı çalıştığını yaz. Örneğin dış servis cevap vermediğinde form metninin korunması, kullanıcı için gözlenebilir bir sonuçtur. Teknik açıklamayı bu davranış etrafında kurmak, incelemeyi kolaylaştırır.

Varsayımları küçük tut

Bir çözümün hangi girişleri beklediğini ve hangilerini reddettiğini belirt. Tüm sistemin aynı şekilde davranacağını varsaymak yerine, sorumluluk sınırını açık tut. Küçük bir modülün giriş ve çıktısı net olduğunda, başka bir yerde kullanılmasını değerlendirmek de kolaylaşır.

Kontrolü riske göre seç

Bir görsel boşluğunu değiştirmek ile yetki kontrolünü değiştirmek aynı doğrulama ihtiyacına sahip değildir. Kullanıcının kaydını, erişimini veya para akışını etkileyen davranışlar için daha güçlü kontrol gerekir. Her değişiklikte, yanlış bir sonuç oluştuğunda neyin etkileneceğini sor.

İyi bir devir notu bırak

Ne değişti, neden değişti ve hangi koşulda denendi? Bu üç soruya kısa, somut cevaplar bırak. Bir başkasının aynı kararı yeniden keşfetmek zorunda kalmaması, bakımın önemli bir parçasıdır.