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

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

• Yapılan değişiklikleri belgelememek
• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Hatayı yeniden üretmeden kod değiştirmek

05Kapsamı ve maliyeti etkileyenler

• aylık bakım mı olay bazlı iş mi
• erişimlerin hazır olup olmadığı
• aciliyet ve destek penceresi
• dokümantasyon ve test kapsamı

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

• Mobil uygulamalar
• Yarım kalan projeler
• Özel yazılımlar
• Eski (legacy) sistemler

07Hangi durumlarda gündeme gelir?

Yazılım yavaşladığında

Profil analiziyle darboğaz bulunur; sorgu, önbellek ve kod iyileştirmesi yapılır.

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.

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

• Hata kayıtları önceliğe göre sınıflandırılır.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.
• Dokümantasyon değişikliklerle birlikte güncellenir.

09Planlama notları

• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.

10Çelikhan'da uzman desteği

Çelikhan'ın PTT verisindeki 58 yerleşim kaydı 3 farklı posta koduna dağılır.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Çelikhan'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 Tut, Sincik ve Kahta 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
• teknik borç
• otomatik test
• test ortamı
• hata kaydı
• Adıyaman
• Çelikhan