Kaynak kod düzenleme ve dokümantasyon: kendin yap mı, uzman mı? (Bahçelievler)

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

• Test ortamı olmadan canlıda düzeltme yapmak
• Yapılan değişiklikleri belgelememek
• Tüm sistemi aynı anda yeniden yazmaya kalkmak

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

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

06Planlama notları

• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.

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

• Eski (legacy) sistemler
• Web siteleri
• E-ticaret siteleri
• Mobil uygulamalar

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

09Kapsamı ve maliyeti etkileyenler

• dokümantasyon ve test kapsamı
• aciliyet ve destek penceresi
• kullanılan teknolojilerin güncelliği
• kod tabanının büyüklüğü ve durumu

10Bahçelievler'de uzman desteği

Bahçelievler'in PTT verisindeki 11 yerleşim kaydı 3 farklı posta koduna dağılır. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için kaynak kod düzenleme ve dokümantasyon tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.

Mesafe yazılım işinin önünde engel değildir: Bahçelievler'deki 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.

Aynı ildeki Esenler, Küçükçekmece ve Beşiktaş 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
• refactoring
• hata kaydı
• otomatik test
• İstanbul
• Bahçelievler