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

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

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

Sürüm kontrolü kullanmamak

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

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

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

• Web siteleri
• Yarım kalan projeler
• E-ticaret siteleri
• Mobil uygulamalar

05Hangi 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.

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

• 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.
• Dokümantasyon değişikliklerle birlikte güncellenir.

07Planlama 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.

08Doğanyurt'ta destek

Doğanyurt, Kastamonu iline bağlı bir ilçedir ve PTT adres verisine göre 87 mahalle ve köy kaydından oluşur.

Mesafe yazılım işinin önünde engel değildir: Doğanyurt'taki ekiplerle görüntülü görüşme, ekran paylaşımı ve test ortamı bağlantısıyla çalışılır; cihaz kurulumu veya saha keşfi gerekirse yerinde ziyaret planlanır.

Kastamonu genelinde Azdavay, Hanönü ve Tosya 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
• teknik borç
• refactoring
• sürüm yükseltme
• Kastamonu
• Doğanyurt