Problem Günlüğü Tutma Alışkanlığı: Teknik Yaşamda İz Bırakmak ve Tekrar Eden Hatalardan Kaçınmak

Teknik dünyada çalışırken günümüzün büyük bir kısmı bilinmeyenleri araştırmak, sistemleri anlamak ve karşımıza çıkan engelleri aşmakla geçer. Saatler hatta günler süren bir hata ayıklama (debugging) seansının ardından nihayet çalışan bir çözüm bulduğumuzda yaşadığımız rahatlama hissi büyüktür. Çözüm bulunduktan sonra terminal pencereleri kapatılır, sekmeler sonlandırılır ve sıradaki işe geçilir. Peki, o gün çözülen ve belki de bir daha asla hatırlanmayacağını sandığımız o spesifik sorun, bundan altı ay sonra tekrar karşımıza çıktığında ne olur?

Çoğumuzun verdiği refleks aynıdır: Yeniden arama motorlarında aynı sorguları aratmak, aynı forum sitelerinde gezinmek ve çözüme ulaşmak için tekrar vakit harcamak. İşte bu döngü, teknik yaşamdaki en büyük zaman ve enerji kayıplarından biridir. Bu yazıda, sadece teknik kariyerinizi değil, genel yaşam kalitenizi de doğrudan etkileyecek olan “problem günlüğü” tutma alışkanlığını, bunun pratik yöntemlerini ve sahada nasıl uygulanabileceğini ele alacağız.

Problem Günlüğü Nedir ve Neden Hayatidir?

Problem günlüğü, karşılaştığınız teknik zorlukları, bunları çözmek için izlediğiniz yolları, başarısız denemelerinizi ve nihai sonucu kaydettiğiniz kişisel bir veri tabanıdır. Bu bir hata takip sistemi (Jira, Trello vb.) değildir; tamamen size ait, sizin zihin yapınıza uygun olarak şekillenmiş bir bilgi bankasıdır.

İnsan hafızası yaratıcı düşünmek ve büyük resmi görmek için tasarlanmıştır, detayları uzun süre saklamak için değil. Bir komutun parametresini, bir kütüphanenin versiyon uyumsuzluğu nedeniyle atılması gereken adımı ya da bir ağ sorununu çözerken kullanılan özel bir route kuralını akılda tutmaya çalışmak zihinsel bir yüktür. Problem günlüğü tutmak, bu zihni yükü dış bir kaynağa devretmek anlamına gelir.

Yaşam kategorisinde ele aldığımızda, bu alışkanlık sadece iş verimliliğini artırmakla kalmaz; aynı zamanda tükenmişlik (burnout) hissiyatını da azaltır. Çünkü insan, daha önce çözdüğü bir sorunu tekrar çözemediğini fark ettiğinde veya aynı problemi çözmek için tekrar saatler harcadığında bir çaresizlik hisseder. Günlük tutmak, “Ben bunu daha önce çözdüm ve nasıl çözeceğimi biliyorum” güvenini kazandırır.

Günlük Tutmaya Başlarken: Araç Seçimi Nasıl Yapılmalı?

Bir sistem kurarken veya günlük tutarken en sık yapılan hata, aşırı karmaşık araçlar seçmektir. “En iyi araç, kullandığınız araçtır” mottosu burada da geçerlidir. Günlüğünüzü tutarken dikkat etmeniz gereken en önemli kural: Erişilebilirliği ve yazılması kolay olmalıdır.

İşte sahada sıklıkla tercih edilen bazı yaklaşımlar:

Plain Text / Markdown Dosyaları: Git tabanlı bir repoda (issues.md veya troubleshooting.md gibi) tutulan düz metin dosyaları. Taşınabilirdir, versiyon kontrolü yapılabilir ve ömürlüktür.
Kişisel Wiki Sistemleri (Obsidian, Logseq, Notion): Özellikle Markdown destekli ve bağlantı kurma (backlink) yeteneği olan araçlar, benzer problemler arasında ilişki kurmanızı sağlar.
Geleneksel Defter ve Kalem: Dijital ekranlardan uzaklaşmak isteyenler için fiziksel bir defter. Özellikle mimari kararları ve zihinsel süreçleri yazarken el yazısının hafızada kalıcılığı artırdığı bilinmektedir.

Seçiminiz ne olursa olsun, sistemin sürtünmesiz (frictionless) olması gerekir. Sorunu çözdükten sonra not almak 2 dakikadan uzun sürüyorsa, o sistemi sürdürmekte zorlanabilirsiniz.

Etkili Bir Problem Kaydı Nasıl Oluşturulur?

Her problem günlüğe aynı standartta kaydedilmelidir. Standartlaşma, ileride arama yaptığınızda aradığınızı saniyeler içinde bulmanızı sağlar. Bir problem kaydında mutlaka bulunması gereken bileşenler şunlardır:

Başlık: Problemin özeti ve etkilenen sistem (Örn: Nginx Reverse Proxy ile WebSocket Bağlantı Kopması).
Tarih ve Bağlam: Sorun ne zaman yaşandı? Hangi ortamda (Test, Prod, Lokal) gerçekleşti?
Belirtiler (Symptom): Karşılaşılan hata mesajları, log çıktıları veya beklenmeyen davranışlar.
Kök Neden (Root Cause): Sorunun kaynağı tam olarak neydi? (Yüzeydeki belirti değil, derinlerdeki neden).
Çözüm Adımları: Problemi çözen kesin ve net adımlar. Kod blokları, komutlar.
Alınan Ders (Takeaway): Bu sorundan ne öğrendim? Bir daha olmaması için ne yapılmalı?

Örnek Bir Problem Kaydı Şablonu

## [2023-10-25] - Docker Konteyner İçinden Host Servisine Erişememe

### Bağlam
Ubuntu 22.04 üzerinde çalışan bir Node.js uygulamasını Dockerize ederken, host makinedeki yerel PostgreSQL veritabanına bağlanmaya çalıştım.

### Hata Mesajı
\`\`\`text
Knex: সংযোগ ব্যর্থ (Connection refused) at 127.0.0.1:5432
\`\`\`

### Kök Neden
Docker konteynerleri kendi network namespace'leri içinde çalışır. Bu yüzden konteyner içindeki \`127.0.0.1\` ifadesi host makineyi değil, konteynerin kendisini işaret eder.

### Çözüm
1. Linux üzerinde host IP adresine erişmek için \`172.17.0.1\` adresi kullanılabilir.
2. Veya docker run komutuna \`--add-host=host.docker.internal:host-gateway\` parametresi eklenerek doğrudan bu isim kullanılabilir.

### Kod Örneği
\`\`\`yaml
services:
  app:
    build: .
    extra_hosts:
      - "host.docker.internal:host-gateway"
\`\`\`

### Alınan Ders
Konteyner mimarilerinde localhost kavramının izole olduğunu asla unutma. Ağ mimarisini baştan planla.

Bu Alışkanlığı Yaşam Tarzına Dönüştürmek

Bir alışkanlığı kazanmanın en zor kısmı sürekliliktir. Problem günlüğünü sürdürülebilir kılmak için günlük rutininize entegre etmeniz gerekir. Bunun için şu stratejileri uygulayabilirsiniz:

Sorun Çözüldüğü An Not Alın: “İşimi bitireyim, akşam yazarım” demeyin. Akşam o detayı hatırlamayacaksınız veya üşeneceksiniz. Çözüm doğrulanır doğrulanmaz 2 dakikanızı ayırıp notu düşün.
Mükemmeliyetçilikten Kaçının: Notlarınızın düzenli, estetik veya herkesin anlayabileceği kadar “temiz” olması gerekmiyor. Sadece sizin anlayacağınız bir taslak bile yeterlidir. Önemli olan bilgiye ulaşmaktır, biçim değil.
Haftalık Gözden Geçirme: Haftada bir kez (örneğin cuma öğleden sonra veya hafta sonu başlangıcında) günlüğünüze şöyle bir göz atın. O hafta hangi zorluklarla baş ettiniz? Hangi konularda tekrar eden hatalar yaptınız? Bu gözden geçirme, öğrenme döngünüzü hızlandırır.

Sonuç

Teknik yaşam, sürekli öğrenme ve unutma döngüsü üzerine kuruludur. Yeni teknolojiler öğrenirken eski bilgilerin zihnimizden silinmesi kaçınılmazdır. Ancak problem günlüğü tutarak bu silinme sürecini kendi lehinize çevirebilir, kendi bilgi tabanınızı oluşturabilirsiniz.

Unutmayın, en iyi sistem yöneticileri veya geliştiriciler her şeyi ezbere bilenler değil, karşılaştıkları sorunları kalıcı bir öğrenme fırsatına dönüştürenlerdir. Bugün attığınız küçük bir not, yarın yaşayacağınız saatler süren bir baş ağrısının önüne geçecektir.

Bu yazı Gemini ile otomatik oluşturulmuştur.