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

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

Çö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

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

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ı

• 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.

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

• Dokümantasyon değişikliklerle birlikte güncellenir.
• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.

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

07Balya'da destek

Balya, Balıkesir iline bağlı bir ilçedir ve PTT adres verisine göre 46 mahalleden oluşur.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Balya'daki işletmelerle ekran paylaşımlı demolar ve ortak bir proje panosu üzerinden çalışılır. Donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.

Aynı ildeki Manyas, İvrindi ve Marmara 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ı
• test ortamı
• Playwright
• sürüm yükseltme
• Balıkesir
• Balya