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

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

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

Sürüm kontrolü kullanmamak

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

Tüm sistemi aynı anda yeniden yazmaya kalkmak

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

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

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

• Bağımlılık güvenlik uyarıları düzenli taranır.
• Hata kayıtları önceliğe göre sınıflandırılır.
• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.

05Planlama notları

• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.

06Kapsamı ve maliyeti etkileyenler

• dokümantasyon ve test kapsamı
• kullanılan teknolojilerin güncelliği
• kod tabanının büyüklüğü ve durumu
• aciliyet ve destek penceresi

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

• Mobil uygulamalar
• Web siteleri
• Eski (legacy) sistemler
• E-ticaret siteleri

08Hangi durumlarda gündeme gelir?

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.

Yeni özellik eklemek her seferinde riskli olduğunda

Kod iyileştirme ve test otomasyonu ile değişiklik maliyeti düşürülür.

09Tatvan'da destek

Tatvan'ın PTT verisindeki 119 yerleşim kaydı 3 farklı posta koduna dağılır.

Tatvan'da 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 Güroymak, Ahlat ve Hizan 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
• hata kaydı
• refactoring
• Playwright
• Bitlis
• Tatvan