Kaynak kod düzenleme ve dokümantasyon: kendin yap mı, uzman mı? (Arıcak)

01Kendiniz yapabilecekleriniz

• tüm erişim bilgilerini tek listede toplamak
• hataları ekran görüntüsü ve adımlarıyla kaydetmek
• kritik iş akışlarını yazılı hale getirmek

02Uzman gerektirenler

• kod denetimi ve teknik borç analizi
• regresyon testleriyle güvenli düzeltme
• sürüm yükseltme ve mimari iyileştirme

03Belirti, neden ve çözüm

04Yanlış uygulamanın riskleri

• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Test ortamı olmadan canlıda düzeltme yapmak
• Sürüm kontrolü kullanmamak

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

• 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.
• Hata kayıtları önceliğe göre sınıflandırılır.

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

• Özel yazılımlar
• Mobil uygulamalar
• E-ticaret siteleri
• Web siteleri

07Hangi durumlarda gündeme gelir?

Yazılımı geliştiren firma artık ulaşılamaz olduğunda

Kaynak kod düzenleme ve dokümantasyon kapsamında kod ve erişimler devralınır, belgelenir ve risk analizi çıkarılır.

Yeni özellik eklemek her seferinde riskli olduğunda

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

08Kapsamı ve maliyeti etkileyenler

• erişimlerin hazır olup olmadığı
• kullanılan teknolojilerin güncelliği
• aylık bakım mı olay bazlı iş mi
• aciliyet ve destek penceresi

09Planlama notları

• 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.
• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.

10Arıcak'ta uzman desteği

Arıcak, Elazığ iline bağlı bir ilçedir ve PTT adres verisine göre 39 mahalle ve köy kaydından oluşur.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Arıcak'taki 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.

Elazığ genelinde Kovancılar, Karakoçan ve Elazığ Merkez 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
• refactoring
• otomatik test
• Elazığ
• Arıcak