Kod yazdırırken doğru tarif: küçük parça, örnek girdi, beklenen çıktı

Programcı olmayan biri de kod yazdırabilir; şart, işi küçük tutmak ve tarifi tam yazmaktır. İyi bir tarif üç şeyi söyler: girdi ne, çıktı ne, kısıt ne. "Bir tarih fonksiyonu yaz" değil, "tarih dizisi al, üç gün önce gibi Türkçe metin döndür". Araç yalnız kodu değil, ne yaptığını, nerede patlayabileceğini ve nasıl test edileceğini de verir. Kural şu: anlamadığın kodu çalıştırma.

Hangi işler kod yazdırmaya uygun?

Kod yazdırmak küçük ve sınırı belli işlerde işe yarar: bir dosyadaki satırları başka biçime çevirmek, bir formun boş alan kontrolü, bir hesap betiği, bir listeyi sıralamak. Bütün bir site ya da uygulama yazdırmak işe yaramaz; sonuç çalışıyor gibi görünür ama kimse neyin nerede olduğunu bilmez. Büyük bir işi küçük parçalara böl ve her parçayı ayrı yazdır. Araç bir görevde iki bin karakter, kodda yirmi bin karakter alır; bu sınır, işin küçük tutulmasını zaten ister.

Tarif nasıl yazılır?

Tarif üç sorudan kurulur. Girdi: fonksiyon ne alacak, hangi biçimde, örneğin "gün ay yıl biçiminde bir tarih metni". Çıktı: ne dönecek, örneğin "üç gün önce gibi Türkçe bir cümle". Kısıt: hangi dil ya da çerçeve, dış paket kullanılsın mı, hangi sürüm, bellek ya da hız sınırı var mı. Kısıt yazmazsan araç kendi kısıtını uydurur ve senin ortamına uymayan bir kod gelir.

Bir örnek girdi ve beklenen çıktı ekle. "Girdi: 2026-09-19, bugün 2026-09-22, çıktı: 3 gün önce" cümlesi tarifin tamamını kilitler. Elinde düzeltilecek ya da değiştirilecek bir kod varsa onu da yapıştır; kod olmadan yapılan değişiklik tahmindir ve olanı vermek çıktıyı ikiye katlar.

Gelen kod nasıl kullanılır?

Çıktı dört parçadır: kod, ne yaptığı ya da ne değiştiği, dikkat edilecekler ve test önerileri. Kodu yapıştırmadan önce ilk üçünü oku. "Dikkat edilecekler" bölümü, kodun hangi durumda patlayacağını söyler: boş girdi, yanlış biçim, büyük dosya. Test önerisini gerçekten çalıştır; Usta kademesinde gerçek bir test iskeleti gelir. Testi geçmeyen kod kullanılmaz.

Araç burada: kod yazma ve düzenleme. Hızlı kademe küçük fonksiyonlar ve tek dosyalık işler için yeterlidir ve taslak çıkarmak için iyidir. Usta kademesi kenar durumlarını, hata yönetimini ve karmaşıklık analizini dahil eder; değişiklik görevlerinde satır satır "ne değişti" listesi verir.

Anlamadan yapıştırmak neden tehlikeli?

Anlamadığın kod, çalıştığında bile senin değildir. Bir gün bozulduğunda ne yapacağını bilmezsin ve düzeltmek için yeniden yazdırırsın, o da bir öncekini anlamadan. Bu yüzden her parçada açıklamayı oku ve kendi cümlenle söyleyebildiğinden emin ol. Söyleyemiyorsan araca açıklamasını daha sade yazmasını söyle. Kodun ne yaptığını anlatabilen kişi onu kullanabilir, anlatamayan kişi ona muhtaçtır.

Bir de güvenlik. Tarife şifre, API anahtarı, müşteri verisi ve gizli bağlantı koyma; örnek veri uydur. Dosya silen, veritabanını değiştiren ya da internete bir şey gönderen kodu önce örnek verilerle deneme ortamında çalıştır, sonra gerçek verilerle. Sitene koyacağın bir formun kodunu, yapıştırmadan önce bir bilen kişiye göstermek iki dakikadır ve bir sızıntıdan ucuzdur.

Nerede uzman gerekir?

Ödeme, kullanıcı girişi, kişisel veri ve para hesabı içeren her iş uzman ister. Bunlarda yanlış kod sessizce çalışır ve zarar ay sonunda görülür. Araç bu işlerde de kod yazar, ama kodu değerlendirecek bilgi sende yoksa sonucu değerlendiremezsin. Küçük betik ve form işleri senin, para ve veri işleri bir geliştiricinindir.

Sıradaki adım

Elle yaptığın küçük bir işi seç: bir dosyayı çevirmek, bir listeyi düzenlemek. Girdi, çıktı ve kısıtı bir örnekle yaz, hızlı kademeyle yazdır, açıklamayı oku, testi çalıştır. Aynı tarif mantığı Excel formülü ve SQL sorgusu için de geçerlidir: Excel formülünü tarif ederek yazdırmak, SQL bilmeden rapor sorusu sormak.