Kaynak kod düzenleme ve dokümantasyon sırasında sık yapılan hatalar (Genç)

01Sık yapılan hatalar

Test ortamı olmadan canlıda düzeltme yapmak

Sonucu hemen görülmeyebilir; ancak birkaç gün içinde veri kaybı veya kesinti olarak ortaya çıkar.

Hatayı yeniden üretmeden kod değiştirmek

Bu hata çoğu zaman geri dönüşü zor bir durum yaratır; önce yedek ve test ortamı şarttır.

Sürüm kontrolü kullanmamak

Çözümü basittir ama sonradan düzeltmek iş yükünü katlar.

Tüm sistemi aynı anda yeniden yazmaya kalkmak

Sonucu hemen görülmeyebilir; ancak birkaç gün içinde veri kaybı veya kesinti olarak ortaya çıkar.

Yapılan değişiklikleri belgelememek

Sonucu hemen görülmeyebilir; ancak birkaç gün içinde veri kaybı veya kesinti olarak ortaya çıkar.

02Doğru yaklaşım

• Önce yedek, sonra tespit
• Değişiklikleri test ortamında denemek
• Her adımı kayıt altına almak
• Sonucu ölçümle doğrulamak

03Belirti, neden ve çözüm

04Planlama notları

• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.
• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.

05Hangi durumlarda gündeme gelir?

Yazılım yavaşladığında

Profil analiziyle darboğaz bulunur; sorgu, önbellek ve kod iyileştirmesi yapılır.

README gerektiğinde

README, kaynak kod düzenleme ve dokümantasyon projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.

06Kapsamı ve maliyeti etkileyenler

• aciliyet ve destek penceresi
• dokümantasyon ve test kapsamı
• aylık bakım mı olay bazlı iş mi
• erişimlerin hazır olup olmadığı

07Genç'te destek

Genç, Bingöl iline bağlı bir ilçedir ve PTT adres verisine göre 318 mahalle ve köy kaydından oluşur.

Genç'te bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.

Aynı ildeki Bingöl Merkez, Yedisu ve Yayladere ilçeleri için de kaynak kod düzenleme ve dokümantasyon talepleri değerlendirilir; toplantılar uzaktan yapılır.

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• README
• mimari şema
• kurulum kılavuzu
• bakım sözleşmesi
• dokümantasyon
• Git
• refactoring
• otomatik test
• Playwright
• Bingöl
• Genç