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

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
• Yapılan değişiklikleri belgelememek

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

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.

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

• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
• 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.

07Kapsamı 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

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

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

09Planlama notları

• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.
• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.

10Adıyaman'da uzman desteği

Adıyaman, Güneydoğu Anadolu Bölgesi'nde yer alan, plaka kodu 02 olan bir ildir; PTT verisine göre 9 ilçe ve 1.117 mahalle ve köy kaydından oluşur.

Mesafe yazılım işinin önünde engel değildir: Adıyaman'daki 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.

Güneydoğu Anadolu Bölgesi'ndeki Şanlıurfa, Siirt ve Mardin gibi illerdeki işletmelerle de 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
• Playwright
• sürüm yükseltme
• otomatik test
• refactoring
• Adıyaman