WY · BÖLÜM 07 · FÖY 140
YAZ-140 · Yazılım & Teknik · ~2 dk

Sert kod inceleme yorumlarini yapici ve gerekceli hale getir

Elindeki her sert yorumun karsiliginda gozlem + gerekce + somut oneri seklinde, dogrudan incelemeye yapistirilabilir bir versiyon alirsin.

Kanca

Kod incelemede "bu yanlis, boyle olmaz" yazdin. Teknik olarak haklisin ama karsi taraf savunmaya geciyor, inceleme dogru cozumu bulmak yerine ego savasina donuyor. Ayni itirazi gerekcesiyle ve dogru tonda yazsan hem kod duzelir hem masa bozulmaz.

Hamle — Claude / ChatGPT (ikisi de calisir)
Prompt — kopyala & yapıştır
Rol: Sen deneyimli bir yazilim gelistiricisisin ve kod inceleme yorumlarimi yapici hale getiriyorsun.

Sana bir veya birden fazla kod inceleme yorumu verecegim (bazen sert, kisa ya da suclayici olabilir). Bazen ilgili kod parcasini da ekleyecegim. Gorevin: ayni teknik itirazi koruyarak her yorumu saygili, gerekceli ve ego incitmeyen hale getirmek.

Kurallar:
1. Teknik itirazi ZAYIFLATMA. Sorun neyse net kalsin; sadece ton ve gerekce degissin. Yumusatiyorum diye itirazi belirsizlestirme.
2. Her yorum icin su uc parcayi uret:
   - Gozlem: sorunu tarafsiz anlat, kisiyi degil kodu/satiri isaret et.
   - Neden onemli: itirazin teknik gerekcesi (okunabilirlik, hata riski, kenar durum, performans, bakim, guvenlik vb.).
   - Oneri: somut ve uygulanabilir bir alternatif ya da acik uclu bir soru.
3. Emir kipi yerine oneri/soru dili kullan. "...yapmalisin" degil, "...soyle yapsak riski azalir mi", "burada ... durumu patlatir mi" gibi.
4. Suclayici ifadeleri ("neden boyle yaptin", "yanlis", "kotu", "sacma") tarafsiz dile cevir.
5. TAHMIN YURUTME. Bir yorumda teknik gerekce yoksa ve kodtan da cikaramiyorsan, o yorumun "Neden onemli" kismina [EKSIK: gerekce ekle] yaz. Gerekce UYDURMA.
6. Kodun ne yaptigindan emin degilsen varsayim yazma; ilgili yere [EKSIK: netlestir] koy.
7. Sahte kod, uydurma satir numarasi ya da olmayan bir davranis uretme. Sadece verdigim icerige dayan.
8. Turkce yaz. Ton: yan masadaki tecrubeli is arkadasi. Ne yaltaklan ne de tepeden bak.

Once yorumlari bekle. Ben yorumlari yapistirana kadar cikti uretme.

Sert yorum(lar):
"""
[buraya sert inceleme yorumlarini yapistir]
"""

Ilgili kod (opsiyonel):
"""
[varsa kod parcasini yapistir]
"""
Çıktı

Elindeki her sert yorumun karsiliginda gozlem + gerekce + somut oneri seklinde, dogrudan incelemeye yapistirilabilir bir versiyon alirsin. Gerekcesi olmayan yorumlar EKSIK etiketiyle isaretlenir, boylece uydurmadan sen tamamlarsin. Birkac yorum icin genelde birkac dakika.

Kariyer çentiği

Zoru dogru tonda soyleyebilen kisi ekipte hem teknik otorite hem guvenilen kisi olur; sadece "haklı olan" degil, birlikte calisilmak istenen kisi sensin.

Sınır

Ton duzeltmesi yanlis teknik itirazi dogru yapmaz; once itirazin gercekten dogru mu ondan emin ol. Ayrica yasal/gizli kod parcalarini bir araca yapistirmadan once sirket veri politikasini kontrol et.

Örnek — bu prompt ne üretir?
Örnek girdi
Sert yorum(lar):
"""
"bu fonksiyon berbat ya, hiç okunmuyor, neden böyle yazdın"
"yanlış. burada hata kontrolü yok, kesin patlar"
"getData getData2 getData3 ne bu isimlendirme, saçma"
"bu döngü çok yavaş olur, performans felaket"
"bunu neden buraya koydun, mantıksız gelmedi"
"bu kısım hiç hoşuma gitmedi"
"""

Ilgili kod (opsiyonel):
"""
def getData2(u):
    r = requests.get(BASE_URL + "/" + u)
    return r.json()["items"]
"""
Çıktı

1. "bu fonksiyon berbat, hiç okunmuyor, neden böyle yazdın"

  • Gözlem: getData2 fonksiyonu tek satırda hem URL kuruyor hem istek atıp hem de yanıtı ayrıştırıyor; adımlar iç içe olduğu için okurken takip etmek zor.
  • Neden önemli: Okunabilirlik. Tek ifadede birden çok iş yapıldığında sonraki kişi (ve 3 ay sonra sen) hangi adımın patladığını ayıklamakta zorlanır, bakım maliyeti artar.
  • Öneri: Adımları ayırıp anlamlı ara değişkenlere alsak (url = ..., resp = ..., payload = ...) okunması kolaylaşır mı? Böyle bir bölme sana da mantıklı geliyor mu?

2. "yanlış, burada hata kontrolü yok, kesin patlar"

  • Gözlem: requests.get(...) sonrası durum kodu kontrol edilmeden r.json()["items"] çağrılıyor.
  • Neden önemli: Hata riski / kenar durum. İstek 404 veya 500 dönerse ya da yanıtta items anahtarı yoksa satır KeyError/JSONDecodeError ile patlar; hata mesajı da kök nedeni göstermez.
  • Öneri: resp.raise_for_status() ekleyip resp.json().get("items", []) gibi güvenli erişim kullansak bu durumları erken yakalar mıyız?

3. "getData getData2 getData3 ne bu isimlendirme, saçma"

  • Gözlem: Fonksiyon adları yalnızca sıra numarasıyla ayrışıyor; ne getirdikleri isimden anlaşılmıyor.
  • Neden önemli: Bakım/okunabilirlik. Numaralı isimler çağrı yerinde hangisinin ne yaptığını gizler, yanlış fonksiyonu çağırma riskini artırır.
  • Öneri: İşlevi yansıtan isimler (fetch_user, fetch_orders gibi) versek çağıran taraf için daha net olur mu?

4. "bu döngü çok yavaş olur, performans felaket"

  • Gözlem: Bahsedilen döngü paylaşılan kod parçasında görünmüyor. [EKSIK: netleştir — hangi dosya/satırdaki döngü?]
  • Neden önemli: [EKSIK: gerekçe ekle — neden yavaş? N+1 istek, iç içe döngü, büyük veri kümesi mi?]
  • Öneri: İlgili döngüyü paylaşır mısın; darboğazı birlikte ölçüp (ör. çağrı sayısı/karmaşıklık) somut bir alternatif çıkaralım.

5. "bunu neden buraya koydun, mantıksız gelmedi"

  • Gözlem: Bu yerleşimin neden sorun olduğu belirtilmemiş.
  • Neden önemli: [EKSIK: gerekçe ekle — katman ihlali mi, yanlış modül mü, bağımlılık yönü mü?]
  • Öneri: Hangi konumun daha uygun olduğunu düşündüğünü yazar mısın; taşımanın somut faydasını netleştirelim.

6. "bu kısım hiç hoşuma gitmedi"

  • Gözlem: Yorumda hangi kısmın ve neyin sorun olduğu belirtilmemiş.
  • Neden önemli: [EKSIK: gerekçe ekle — teknik gerekçe yok; kişisel tercih mi yoksa somut bir risk mi?]
  • Öneri: Rahatsız eden noktayı satır bazında işaret edip beklentini yazsan üzerine somut konuşabiliriz.

ÜRETİM: TEM 2026 · CLAUDE Bu kayıt eşlenmiş örnek girdi ve çıktı içerir. Model koşumu kanıtı yoktur — kendi verinle doğrulamadan karar girdisi yapma.

Kendi verinle çalıştır
Verini aşağıya yapıştır; prompt seninkiyle birleşip çalıştırmaya hazır tek bloğa dönüşsün. Sonra tek dokunuşla Claude ya da ChatGPT'de aç.
Hazır prompt — verini bekliyor
Rol: Sen deneyimli bir yazilim gelistiricisisin ve kod inceleme yorumlarimi yapici hale getiriyorsun.

Sana bir veya birden fazla kod inceleme yorumu verecegim (bazen sert, kisa ya da suclayici olabilir). Bazen ilgili kod parcasini da ekleyecegim. Gorevin: ayni teknik itirazi koruyarak her yorumu saygili, gerekceli ve ego incitmeyen hale getirmek.

Kurallar:
1. Teknik itirazi ZAYIFLATMA. Sorun neyse net kalsin; sadece ton ve gerekce degissin. Yumusatiyorum diye itirazi belirsizlestirme.
2. Her yorum icin su uc parcayi uret:
   - Gozlem: sorunu tarafsiz anlat, kisiyi degil kodu/satiri isaret et.
   - Neden onemli: itirazin teknik gerekcesi (okunabilirlik, hata riski, kenar durum, performans, bakim, guvenlik vb.).
   - Oneri: somut ve uygulanabilir bir alternatif ya da acik uclu bir soru.
3. Emir kipi yerine oneri/soru dili kullan. "...yapmalisin" degil, "...soyle yapsak riski azalir mi", "burada ... durumu patlatir mi" gibi.
4. Suclayici ifadeleri ("neden boyle yaptin", "yanlis", "kotu", "sacma") tarafsiz dile cevir.
5. TAHMIN YURUTME. Bir yorumda teknik gerekce yoksa ve kodtan da cikaramiyorsan, o yorumun "Neden onemli" kismina [EKSIK: gerekce ekle] yaz. Gerekce UYDURMA.
6. Kodun ne yaptigindan emin degilsen varsayim yazma; ilgili yere [EKSIK: netlestir] koy.
7. Sahte kod, uydurma satir numarasi ya da olmayan bir davranis uretme. Sadece verdigim icerige dayan.
8. Turkce yaz. Ton: yan masadaki tecrubeli is arkadasi. Ne yaltaklan ne de tepeden bak.

Once yorumlari bekle. Ben yorumlari yapistirana kadar cikti uretme.

Sert yorum(lar):
"""
[buraya sert inceleme yorumlarini yapistir]
"""

Ilgili kod (opsiyonel):
"""
[varsa kod parcasini yapistir]
"""

Yapıştırdığın veri tarayıcından çıkmaz — WhiteYaka'ya gönderilmez. Prompt panoya kopyalanır; açılan sohbete Ctrl/⌘ + V ile yapıştırırsın.

i Bu föy örnek girdi ve çıktı içerir; yapısal doğrulama ve ölçütlü prompt koşumu henüz kaydedilmedi.

Bülten kaydı kapalı.

Bu sayfa e-posta adresi toplamaz ve liste kaydı başlatmaz. 160 hamlenin tamamı giriş yapmadan açık.