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

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

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

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

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?

• Mobil uygulamalar
• Web siteleri
• Eski (legacy) sistemler
• Özel yazılımlar

05Kapsamı ve maliyeti etkileyenler

• aylık bakım mı olay bazlı iş mi
• dokümantasyon ve test kapsamı
• kullanılan teknolojilerin güncelliği
• erişimlerin hazır olup olmadığı

06Planlama notları

• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.
• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.

07Hangi durumlarda gündeme gelir?

Yeni özellik eklemek her seferinde riskli olduğunda

Kod iyileştirme ve test otomasyonu ile değişiklik maliyeti düşürü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.

08Şefaatli'de destek

Şefaatli'nin PTT verisindeki 56 yerleşim kaydı 2 farklı posta koduna dağılır.

Şefaatli'de 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.

Yozgat genelinde Yozgat Aydıncık, Boğazlıyan ve Saraykent gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

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
• sürüm yükseltme
• teknik borç
• Playwright
• Yozgat
• Şefaatli