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

01Sık yapılan hatalar

Test ortamı olmadan canlıda düzeltme yapmak

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

Hatayı yeniden üretmeden kod değiştirmek

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

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

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

Yapılan değişiklikleri belgelememek

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

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

04Kaynak kod düzenleme ve dokümantasyon hangi işletmelerde kullanılır?

• Eski (legacy) sistemler
• Özel yazılımlar
• Web siteleri
• Yarım kalan projeler

05Planlama notları

• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.
• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.

06İşletim ve bakım ipuçları

• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.
• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
• Bağımlılık güvenlik uyarıları düzenli taranır.

07Kapsamı ve maliyeti etkileyenler

• aylık bakım mı olay bazlı iş mi
• kullanılan teknolojilerin güncelliği
• dokümantasyon ve test kapsamı
• kod tabanının büyüklüğü ve durumu

08Hasankeyf'te destek

Hasankeyf'in PTT verisindeki 30 yerleşim kaydı 2 farklı posta koduna dağılır.

Hasankeyf'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 Gercüş, Batman Merkez ve Sason 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
• teknik borç
• test ortamı
• Playwright
• Batman
• Hasankeyf