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

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
• Sürüm kontrolü kullanmamak

05Planlama notları

• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.
• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.

06İş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.
• Dokümantasyon değişikliklerle birlikte güncellenir.

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

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

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.

Yeni özellik eklemek her seferinde riskli olduğunda

Kod iyileştirme ve test otomasyonu ile değişiklik maliyeti düşürülür.

09Kapsamı ve maliyeti etkileyenler

• kullanılan teknolojilerin güncelliği
• aylık bakım mı olay bazlı iş mi
• dokümantasyon ve test kapsamı
• kod tabanının büyüklüğü ve durumu

10Hekimhan'da uzman desteği

Hekimhan, Malatya iline bağlı bir ilçedir ve PTT adres verisine göre 65 mahalleden oluşur. Birden fazla ilçede ekibi veya şubesi olan işletmelerde kaynak kod düzenleme ve dokümantasyon için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.

Mesafe yazılım işinin önünde engel değildir: Hekimhan'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 Malatya Yeşilyurt, Doğanyol ve Yazıhan 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
• test ortamı
• teknik borç
• Malatya
• Hekimhan