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

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
• Hatayı yeniden üretmeden kod değiştirmek
• Yapılan değişiklikleri belgelememek

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

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

06Planlama notları

• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• 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.

07Kapsamı ve maliyeti etkileyenler

• erişimlerin hazır olup olmadığı
• kod tabanının büyüklüğü ve durumu
• aciliyet ve destek penceresi
• aylık bakım mı olay bazlı iş mi

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

• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.
• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
• Bağımlılık güvenlik uyarıları düzenli taranır.

09Hangi durumlarda gündeme gelir?

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

Profil analiziyle darboğaz bulunur; sorgu, önbellek ve kod iyileştirmesi yapı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.

10Bozkır'da uzman desteği

Bozkır, Konya iline bağlı bir ilçedir ve PTT adres verisine göre 52 mahalleden oluşur. 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: Bozkır'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.

Aynı ildeki Sarayönü, Emirgazi ve Derbent 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
• test ortamı
• teknik borç
• otomatik test
• Konya
• Bozkır