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

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
• Test ortamı olmadan canlıda düzeltme yapmak
• Hatayı yeniden üretmeden kod değiştirmek

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

• Bağımlılık güvenlik uyarıları düzenli taranı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.

06Kapsamı ve maliyeti etkileyenler

• erişimlerin hazır olup olmadığı
• aciliyet ve destek penceresi
• dokümantasyon ve test kapsamı
• kod tabanının büyüklüğü ve durumu

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

• Eski (legacy) sistemler
• Mobil uygulamalar
• Yarım kalan projeler
• Web siteleri

08Planlama notları

• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.
• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.

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

10Avcılar'da uzman desteği

Avcılar, İstanbul iline bağlı bir ilçedir ve PTT adres verisine göre 10 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; Avcılar'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 Çekmeköy, Sultanbeyli ve Pendik 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ç
• İstanbul
• Avcılar