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

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
• Hatayı yeniden üretmeden kod değiştirmek
• Sürüm kontrolü kullanmamak

05Planlama notları

• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.
• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.

06Kapsamı ve maliyeti etkileyenler

• dokümantasyon ve test kapsamı
• aylık bakım mı olay bazlı iş mi
• kullanılan teknolojilerin güncelliği
• aciliyet ve destek penceresi

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

• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.
• Dokümantasyon değişikliklerle birlikte güncellenir.

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

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

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 yavaşladığında

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

10Karabük'te uzman desteği

Karabük, Karadeniz Bölgesi'nde yer alan, plaka kodu 78 olan bir ildir; PTT verisine göre 6 ilçe ve 1.096 mahalle ve köy kaydından oluşur.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Karabük'teki 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.

Karadeniz Bölgesi'ndeki Sinop, Düzce ve Ordu 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
• hata kaydı
• refactoring
• sürüm yükseltme
• Karabük